Home

user manual ser manual ser manual - Artoksi Mühendislik Sanatlarý

1. This does not indicate an error This indicates that the instrument does not have such a feature For example if you get character at 38th digit this means that the instrument specified don t have black calibration fetaure Examples Result Anyname2 INSTRUMENT STATUS Form1 MSComml 2 6 KonicaMinolta 3600d instrument status will return as 38 digit string in variable Result using serial channel 2 with MsComml object on form Form1 If command performed successfully then variable Result will return such a string as below Example OKEY 1 1 0 0 0 180173004 180113004 1 1 116 Meaning Viewing area Lens position UV filter position Specular component position Measurement mode Instrument serial no White calibration plate no White calibration Siyah calibration Medium Medium Included 96100 SCI Reflectance 180173004 180113004 Done ok Done ok If command can not performed successfuly then varibale Result will return such a string as below Example HATA Instrument could not communicate with PC Status Anyname2 INSTRUMENT_STATUS Settings MSCommz 2 3 KonicaMinolta 2500d instrument status will return as 38 digit string in variable Status using serial channel 2 with MsComm2 object on form Settings If command performed successfully then variable Result will return such a string as below Example OKEY 0 0 0 1 0 180173004 180113004 1
2. If the operation failed then output parameter will be as follows Sonuc FAIL Insufficient light level Olculen 1 999 Olculen 2 2 999 Olculen 39 999 Olculen 40 999 119 Subroutine no Subroutine name Description Purpose General form Input parameters 7 DOWNLOAD Downloads a color from instruments memory Calling the values of a pre stored color in instrument s memory DOWNLOAD ComObject As Object ComPortNo As Byte Instrument As Byte Adress As Integer Result Mode As String Result UV As String Result Data Type As String Result Name As String Result ColorSpace As String Result LightSourcel As String Result LightSource2 As String Result Observer As String Result Reflectance40 As Single As String Parameter 1 gt ComObject As Object Obejct full name of serial communication object Name of the MsComm object in the form For example Assume that a form namely Form1 and a MsComm object on it namely MsComm1 In this case this parameter will be like this Form1 MsComml Parameter 2 s ComPortNo As Byte A number between 1 to 255 indicating port number of serial commnunication channel Parameter 3 gt Instrument As Byte A number indicating which instrument you use See SUPPORTED INSTRUMENT SELECTION TABLE at the end of this document Parametre 4 gt Adress as Integer An integer between 1 to 699 which represent memory adress of the instrumen
3. Input parameters Parameter 1 gt Reflectance40 Std As Single An array with 40 elements having reflectance values between 360nm 750nm with 10nm intervals of the first color Example Refs 1 12 345 Reflectance value for 360nm Refs 2 11 395 Reflectance value for 370nm Refs 39 32 123 Reflectance value for 740nm Refs 40 36 523 Reflectance value for 750nm Parameter 2 gt Reflectance40_Trial As Single An array with 40 elements having reflectance values between 360nm 750nm with 10nm intervals of the second color Example Refs 1 11 345 Reflectance value for 360nm Refs 2 10 395 Reflectance value for 370nm Refs 39 34 123 Reflectance value for 740nm Refs 40 35 523 Reflectance value for 750nm Parameter 3 gt LightSourcel As String One of the options from LIGHT SOURCES SELECTION REFERENCE TABLE at the end of this document to tell the subroutine which light source will be accepted as the first illuminant Parameter 4 gt LightSource2 As String One of the options from LIGHT SOURCES SELECTION REFERENCE TABLE at the end of this document to tell the subroutine which light source will be accepted as the second illuminant Parameter 3 gt Observer as Byte One of the options below to tell the subroutine which observer for the specified light source will be used for calculation 2 Weighing factors for 2 degree observer will be used 10 gt Weighing factors for 10 degree observer will be used
4. b in CMC coordinate system Minus values represent blue zone Plus values represent yellow zone 23 Parameter 4 gt Result CMC C As Single Returns chroma Duller Sharper value C in CMC coordinate system Parameter 5 gt Result CMC H As Single Returns Hue Pureness value H in CMC coordinate system Notes 1 As all output numeric parameters has decimal point be sure that the type of those parameters are defined properly in your source code In VB6 we use single declaration type to do it For example Dim VariableName as Single Or Public VariableName as Single 2 Reflectance values are values This means that all values are between 0 and 100 3 Output parameters Result Result CMC a Result CMC b and Result CMC H may return plus or minus value so be sure that variable has been defined properly in your code Examples Anyname REFLECTANCE40 CMC CALCULATE RedTTI10 D65 10 Result L Result a Result b Result C Result H L a b C and H values of CMC color space under illuminant Daylight 6500K and 10 degree observer of the color in Array RedTT10 will be returned via variables Result L Result a Result b Result C and Result H consecutively Anyname REFLECTANCE40 CMC CALCULATE Samplel U30 10 CMC L CMC a CMC b CMC C CMC H L a b C H values of CMC color space under illuminant Ultralume 30 3000K and 10 degree observer of the color in array Samplel will be returned via variable
5. 1 Reflectance values are values This means that all values are between 0 to 100 2 Recipe calculation is a patent pending method created by Artoksi This subroutine does not use Kubelka Munk matrix systems Howewer this subroutine is suitable for exhaust dyeing such as textile not pigment dyeing Examples Anyname REFLECTANCE31 RECIPE CALCULATE CalibrationData Substratel Substrate2 TobeCalculatedColor3 10 3 Alternaives True 1300 900 HowMany 92 A recipe or recipes will be calculated according to shades given in three dimensional array CalibrationData and Substratel and Substrate2 Each recipe will contain maximum 3 dyes in it Each alternative will be stored on disk with name Alternatives plus number suffix automatically and number of alternatives will be output via variable HowMany An information screen is also displayed according to the coordinates set as Y 1300 and X 900 Anyname REFLECTANCE31 RECIPE CALCULATE LabData Substrate1 Substratel TobeCalculatedColor31 3 Recipes False 0 0 Pcs A recipe or recipes will be calculated according to shades given in three dimensional array LabData Same substrate which was used during shades preparation will be used Each recipe will contain maximum 3 dyes in it Each alternative will be stored on disk with filename Recipes plus number suffix automatically as text files and number of alternatives will be output via variable Pcs No information scre
6. 15 and 32 elements Another saying that an array defined as DyeShadesReflectance31 1 to 6 1 to 15 and 1 to 32 These three dimensional array is for shades reflectance values also known as calibration data with different concentrations C prepared in laboratory See REFLECTANCE31 RECIPE CALCULATE function Parameter 1 for detailed explanation Parameter 2 gt ShadesSubstrateReflectance31 As Single An array with 31 elements having reflectance values between 400nm 700nm with 10nm intervals of the substrate which was used while preparing shades See REFLECTANCE31 RECIPE CALCULATE function Parameter 2 for detailed explanation Parameter 3 gt TargetSubstrateReflectance31 As Single An array with 31 elements having reflectance values between 400nm 700nm with 10nm intervals of the substrate which will be used for dyeing of the recipe to be calculated This substrate may be the same substrate with ShadesSubstrateReflectance31 See REFLECTANCE31 RECIPE CALCULATE function Parameter 3 for detailed explanation Parameter 4 gt Amounts As Single An 6 element array consist of amount information of each dye in a recipe For example assume that DyeShadesReflectance31 array parameter 1 has data for 3 dyes and the amount of each dye is as follows DYE l den C 2 4 DYE 2 den C 0 55 DYE 3 den C 1 187 In this case Amounts array should be like this Amounts 1 2 4 Amounts 2 0 55 Amounts 3 1 187 Amou
7. 32 123 Reflectance value for 740nm Refs 40 36 523 Reflectance value for 750nm Output parameters Parameter 1 gt Result_ASTMD1925 As Single Returns ASTMD 1925 yellowness indice for the color given with reflectance values Parameter 2 gt Result ASTME313 As Single Returns ASTME313 yellowness indice for the color given with reflectance values Parameter 3 gt Result_BASFGB As Single Returns BASFGB yellowness indice for the color given with reflectance values Notes 1 As all output numeric parameters has decimal point be sure that the type of those parameters are defined properly in your source code In VB6 we use single declaration type to do it For example Dim VariableName as Single or Public VariableName as Single Examples 3 Anyname REFLECTANCE40 YELLOWNESS CALCULATE Sample1 Yellowness1 Yelowness2 Yellowness3 Three types of yellowness indice will be returned via output variables Yellowness1 Yellowness2 and Yellowness3 for the color given in REFLECTANCE40 array 34 Anyname REFLECTANCEA40 YELLOWNESS CALCULATE Sample1 Yellowness1925 Yelowness313 YellownessBASF Three types of yellowness indice will be returned via output variables Yellowness1925 Yellowness313 and YellownessBASF for the color given in REFLECTANCEAO array 35 Subroutine no 16 Subroutine name CAPITALXYZ YELLOWNESS CALCULATE Description Calculates ASTMD1925 ASTME313 and BASFGB yellowness indices for the color given w
8. 59 Output parameters Parameter 1 gt Result Metamerism As Single Returns metamerism index which shows how the difference between two colors is changing when the light source switched from LightSourcel to LightSource2 If Result Metamerism is equal to 1 then metamerism is perfect In another saying that color difference is not changing when the light source changed Be careful Metamerism 1 does not mean that the colors are not changing from one light source to another Metamerism 1 only means that the difference between two colors stay same from one light source to another Notes 1 As all output numeric parameters has decimal point be sure that the type of those parameters are defined properly in your source code In VB6 we use single declaration type to do it For example Dim VariableName as Single or Public VariableName as Single 2 Reflectance values are values This means that all values are between 0 to 100 Examples Anyname REFLECTANCE40 METAMERISM CALCULATE Colorl1 Color2 D65 TL83 10 Met Metamerism index showing difference changing between Color and Color2 under illuminant D65 will be output via variable Met Anyname REFLECTANCEA40 METAMERISM CALCULATE CustomerRed LabRed D65 TL83 10 ResultMet Metamerism index showing difference changing between CustomerRed and LabRed under illuminant D65 will be output via variable ResultMet 60 Subroutine no 31 Subroutine na
9. CIELab CMC CALCULATE 11 CMC DELTA CALCULATE 12 REFLECTANCEA0 RGB CALCULATE 13 CIELab RGB CALCULATE 14 CAPITALXYZ RGB CALCULATE 15 REFLECTANCEA0 YELLOWNESS CALCULATE 4 16 CAPITALXYZ YELLOWNESS CALCULATE 17 REFLECTANCEA0 WHITENESS CALCULATE 18 CAPITALXYZ WHITENESS CALCULATE 19 REFLECTANCEA0 TINT CALCULATE 20 CAPITALXYZ TINT CALCULATE 21 LOWERCASEXYZ TINT CALCULATE 22 REFLECTANCE40 GRAY SCALE CALCULATE 23 CIELab GRAY SCALE CALCULATE 24 CIELabDELTAE GRAY SCALE CALCULATE 25 REFLECTANCEA0 OPACITY CALCULATE 26 CAPITALXYZ OPACITY CALCULATE 27 REFLECTANCE40 STRENGTH CALCULATE 28 REFLECTANCEA0 BRIGHTNESS CALCULATE 29 CAPITALXYZ BRIGHTNESS CALCULATE 30 REFLECTANCEA40 METAMERISM CALCULATE 31 CIELab METAMERISM CALCULATE 32 CIElab METAMERISM DIRECTION CALCULATE 33 REFLECTANCE31 RECETE CALCULATE 34 REFLECTANCE ES CONVERT 35 KS REFLECTANCE CONVERT 36 VERSION 37 CIELab DELTA ASSESSMENTS 38 RECIPE REFLEKTANCE31 CALCULATE 39 RGB CAPITALXYZ CALCULATE 40 CAPITALXYZ CIELab CALCULATE SPECTROPHOTOMETERS MANAGEMENT FUNCTIONS 8 pcs 1 SET INSTRUMENT 2 INSTRUMENT STATUS 3 SHOW 4 CALIBRATE WHITE 5 CALIBRATE BLACK 6 MEASURE 7 DOWNLOAD 8 UPLOAD How these 48 functions can be called from my program or How to include these functions into my source code This is the first in importance benefit which makes this application DLL invaluable Different programming languages h
10. DYE 5 13 shade is absent 85 Later DyeShadesReflectance31 5 14 1 20 DyeShadesReflectance31 5 14 2 20 DyeShadesReflectance31 5 14 3 20 DyeShadesReflectance31 5 14 31 2 0 DyeShadesReflectance31 5 14 32 0 Later DyeShadesReflectance31 5 15 1 20 DyeShadesReflectance31 5 15 2 20 DyeShadesReflectance31 5 15 3 20 DyeShadesReflectance31 5 15 31 2 0 DyeShadesReflectance31 5 15 32 2 0 gt DYE 5 14 shade is absent gt DYE 5 14 shade is absent gt DYE 5 14 shade is absent gt DYE 5 14 shade is absent gt DYE 5 14 shade is absent gt DYE 5 15 shade is absent gt DYE 5 15 shade is absent gt DYE 5 15 shade is absent gt DYE 5 15 shade is absent gt DYE 5 15 shade is absent DYE 5 shades placement into the array has been done Now let s continue with DYE 6 DyeShadesReflectance3 1 6 1 1 0 DyeShadesReflectance3 1 6 1 2 0 DyeShadesReflectance3 1 6 1 3 0 DyeShadesReflectance31 6 1 31 2 0 DyeShadesReflectance31 6 1 32 75 16 Later DyeShadesReflectance3 1 6 2 1 0 DyeShadesReflectance3 1 6 2 2 0 DyeShadesReflectance3 1 6 2 3 0 DyeShadesReflectance31 6 2 31 2 0 DyeShadesReflectance31 6 2 32 0 DYE 6 1 shade is absent DYE 6 1 shade is absent gt DYE 6 1 shade is absent DYE 6 1 shade is absent gt DYE 6 1 shade is absent gt DYE 6 2 shade is absent gt DYE 6 2 shade is absent gt DYE 6 2 shade is absent gt DYE 6 2 shade is
11. DYE 5 9 shade is absent DyeShadesReflectance3 1 5 9 32 0 gt DYE 5 9 shade is absent 84 Later DyeShadesReflectance31 5 10 1 20 DyeShadesReflectance31 5 10 2 20 DyeShadesReflectance31 5 10 3 20 DyeShadesReflectance31 5 10 31 2 0 DyeShadesReflectance31 5 10 32 0 Later DyeShadesReflectance31 5 11 1 20 DyeShadesReflectance31 5 11 2 20 DyeShadesReflectance31 5 11 3 20 DyeShadesReflectance31 5 11 31 2 0 DyeShadesReflectance31 5 11 32 2 0 Later DyeShadesReflectance31 5 12 1 20 DyeShadesReflectance31 5 12 2 20 DyeShadesReflectance31 5 12 3 20 DyeShadesReflectance31 5 12 31 2 0 DyeShadesReflectance31 5 12 32 2 0 Later DyeShadesReflectance31 5 13 1 20 DyeShadesReflectance31 5 13 2 20 DyeShadesReflectance31 5 13 3 20 DyeShadesReflectance31 5 13 31 2 0 DyeShadesReflectance31 5 13 32 2 0 gt DYE 5 10 shade is absent gt DYE 5 10 shade is absent gt DYE 5 10 shade is absent gt DYE 5 10 shade is absent gt DYE 5 10 shade is absent gt DYE 5 11 shade is absent gt DYE 5 11 shade is absent gt DYE 5 11 shade is absent gt DYE 5 11 shade is absent gt DYE 5 11 shade is absent gt DYE 5 12 shade is absent gt DYE 5 12 shade is absent gt DYE 5 12 shade is absent gt DYE 5 12 shade is absent gt DYE 5 12 shade is absent gt DYE 5 13 shade is absent gt DYE 5 13 shade is absent gt DYE 5 13 shade is absent gt DYE 5 13 shade is absent gt
12. Three values between 0 and 255 will be returned via output variables Redl Green1 Bluel for the 3l color given with values L 11 12 a 7 34 and b 21 89 at CIELab color space under D65 light source and 10 degree observer Anyname CIELab RGB CALCULATE 30 06 9 17 CWP 2 13 13 cR cG cB Three values between 0 and 255 will be returned via output variables cR cG cB for the color given with values L 30 06 a 9 17 and bz13 13 at CIELab color space under CWF Coolwhite light source and 2 degree observer 32 Subroutine no 14 Subroutine name CAPITALXYZ RGB CALCULATE Description Calculates R red G Green B blue values from the color given with X Y Z tristimulus values Purpose Send X Y and Z tristimulus values of a color and get R G B values of it General form CAPITALXYZ RGB CALCULATE CAPITAL X As Single CAPITAL Y As Single CAPITAL Z As Single Result Red As Single Result Green As Single Result Blue As Single Input parameters Parameter 1 gt CAPITAL X As Single X tristimulus value of the color Parameter 2 gt CAPITAL Y As Single Y tristimulus value of the color Parameter 3 gt CAPITAL Z As Single Z tristimulus value of the color Output parameters Parameter 1 gt Result Red As Single Returns a red value between 0 255 corresponding to the color given with X Y Z tristimulus values Parameter 2 gt Result Green As Single Returns a green value between 0 255 corresponding to
13. TristZ X Y Z tristimulus values under illuminant Coolwhite 4150K and 2 degree observer of the color in Array40 will be returned via variables TristX Trist Y and TristZ consecutively Subroutine no 2 Subroutine name CIELab CAPITALXYZ CALCULATE Description Calculates X Y and Z tristimulus values from CIE L a and b values of a color Purpose Send CIE L a and b values and get X Y Z tristimulus values General form CIELab CAPITALXYZ CALCULATE CIE L As Single CIE a As Single CIE b As Single LightSource As String Observer As Byte Result CAPITAL X As Single Result CAPITAL Y As Single Result CAPITAL Z As Single Input parameters Parameter 1 gt CIE L As Single L Lightness value at CIELab colorspace of the color Parameter 2 gt CIE a As Single a Red Green value at CIELab colorspace of the color Parameter 3 gt CIE L As Single b Blue Yellow value at CIELab colorspace of the color Parameter 4 gt LightSource As String One of the options from LIGHT SOURCES SELECTION REFERENCE TABLE at the end of this document to tell the subroutine which light source will be used simulated to calculate X Y Z tristimulus values Parameter 3 gt Observer as Byte One of the options below to tell the subroutine which observer for the specified light source will be used to calculate X Y Z tristimulus values 2 Weighing factors for 2 degree observer will be used 10 gt Weighing factors for 10 de
14. shade is absent 73 Later DyeShadesReflectance31 2 11 1 20 DyeShadesReflectance31 2 11 2 20 DyeShadesReflectance31 2 11 3 20 DyeShadesReflectance31 2 11 31 2 0 DyeShadesReflectance31 2 11 32 2 0 Later DyeShadesReflectance31 2 12 1 20 DyeShadesReflectance31 2 12 2 20 DyeShadesReflectance31 2 12 3 20 DyeShadesReflectance31 2 12 31 2 0 DyeShadesReflectance31 2 12 32 0 Later DyeShadesReflectance31 2 13 1 20 DyeShadesReflectance31 2 13 2 20 DyeShadesReflectance31 2 13 3 20 DyeShadesReflectance31 2 13 31 2 0 DyeShadesReflectance31 2 13 32 2 0 Later DyeShadesReflectance31 2 14 1 20 DyeShadesReflectance31 2 14 2 20 DyeShadesReflectance31 2 14 3 20 DyeShadesReflectance31 2 14 31 2 0 DyeShadesReflectance31 2 14 32 0 gt DYE 2 11 shade is absent gt DYE 2 11 shade is absent gt DYE 2 11 shade is absent gt DYE 2 11 shade is absent gt DYE 2 11 shade is absent gt DYE 2 12 shade is absent DYE 2 12 shade is absent gt DYE 2 12 shade is absent gt DYE 2 12 shade is absent DYE 2 12 shade is absent gt DYE 2 13 shade is absent gt DYE 2 13 shade is absent gt DYE 2 13 shade is absent gt DYE 2 13 shade is absent DYE 2 13 shade is absent gt DYE 2 14 shade is absent gt DYE 2 14 shade is absent gt DYE 2 14 shade is absent DYE 2 14 shade is absent gt DYE 2 14 shade is absent 74 Later DyeShadesReflectance31 2 15 1 20 DyeSha
15. 0 01 0 05 0 1 0 15 0 3 0 5 and 1 0 Reflectance values between 400nm 700nm with 10nm intervals of each concentrations are as follows 65 For DYE 1 C 0 005 49 765 48 675 47 51 48 06 49 27 52 415 60 25 67 675 71 24 72 635 13 55 13 155 13 665 73 65 73 805 74 04 74 125 74 12 74 13 74 105 74 015 73 98 74 065 74 19 74 345 74 535 74 705 74 665 74 74 74 81 75 06 For DYE 1 C 0 0075 45 5 43 945 42 485 42 985 44 225 47 63 56 42 65 065 69 44 71 195 72 33 72 73 72 79 72 88 73 105 73 38 73 44 73 295 73 175 72 93 72 59 72 43 72 55 72 885 73 5 74 215 74 845 75 16 75 34 75 415 75 58 For DYE 1 C 0 01 42 36 40 485 38 875 39 275 40 49 43 97 53 515 63 465 68 865 71 14 72 54 73 11 73 235 73 35 73 58 73 86 73 84 73 605 73 385 73 05 72 69 72 585 72 765 73 22 73 92 74 68 75 355 75 685 75 895 76 02 76 23 For DYE 1 C 0 05 25 435 21 91 19 54 19 585 20 485 23 84 36 96 55 355 68 69 74 34 76 515 76 825 76 36 75 985 75 875 75 895 75 715 75 41 75 225 74 965 74 65 74 465 74 44 74 48 74 655 74 9 75 135 75 19 75 19 75 19 75 255 For DYE 1 C 0 1 15 09 12 415 10 725 10 755 11 37 13 735 24 775 43 575 60 1 68 27 71 545 72 355 72 165 71 9 71 84 71 89 71 765 71 505 71 33 71 135 70 9 70 925 71 155 71 49 71 985 72 5 72 93 72 985 73 105 73 425 73 825 For DYE 1 C 0 5 4 68 3 5 2 875 2 885 3 08 3 745 10 19 26
16. 43 59 43 375 40 295 35 015 29 11 23 145 17 95 14 01 10 745 7 75 5 36 4 12 3 83 3 61 3 05 2 73 3 3 5 69 11 475 22 67 39 73 59 For DYE 5 C 0 5 32 015 33 345 31 215 29 1 27 6 28 44 31 405 34 085 35 965 37 4 36 94 33 44 27 84 21 98 16 435 11 94 8 835 6 43 4 38 2 905 2 24 2 125 2 04 1 79 1 645 1 945 3 5 72 12 17 24 185 40 455 For DYE 5 C 1 22 T15 23 81 21 75 19 765 18 395 19 075 21 635 23 88 25 35 26 36 25 57 22 255 17 465 12 775 8 76 5 845 4 065 2 865 1 985 1 46 1 285 1 28 1 275 1 225 1 215 1 29 1 5 1 965 3 74 8 955 18 525 68 According to this scenario the content of the array DyeShadesReflectance31 will form like this Please remember that 1 dimension represent dye number 2 dimension represent shade number and 3 dimension represent C and reflectance values of it between 400nm 700nm with 10nm intervals DyeShadesReflectance31 1 1 1 20 005 DyeShadesReflectance31 1 1 2 249 765 DyeShadesReflectance31 1 1 3 248 675 e e DyeShadesReflectance31 1 1 31 2 74 81 DyeShadesReflectance31 1 1 32 75 06 Later DyeShadesReflectance3 1 1 2 1 0 0075 DyeShadesReflectance31 1 2 2 245 5 DyeShadesReflectance31 1 2 3 243 945 e e DyeShadesReflectance31 1 2 31 2 75 415 DyeShadesReflectance31 1 2 32 2 75 58 Later DyeShadesReflectance31 1 3 1 20 01 DyeShadesReflectance31 1 3 2 242 36 DyeShadesReflectance31 1 3 3 240 485 e e DyeShadesReflec
17. 6 shade is absent e e DyeShadesReflectance3 1 2 6 31 0 gt DYE 2 6 shade is absent DyeShadesReflectance3 1 2 6 32 0 gt DYE 2 6 shade is absent Later DyeShadesReflectance3 1 2 7 1 0 gt DYE 2 7 shade is absent DyeShadesReflectance3 1 2 7 2 0 gt DYE 2 7 shade is absent DyeShadesReflectance3 1 2 7 3 0 gt DYE 2 7 shade is absent DyeShadesReflectance3 1 2 7 31 0 gt DYE 2 7 shade is absent DyeShadesReflectance3 1 2 7 32 0 gt DYE 2 7 shade is absent Later DyeShadesReflectance3 1 2 8 1 0 gt DYE 2 8 shade is absent DyeShadesReflectance3 1 2 8 2 0 gt DYE 2 8 shade is absent DyeShadesReflectance3 1 2 8 3 0 DYE 2 8 shade is absent DyeShadesReflectance31 2 8 31 2 0 DYE 2 8 shade is absent DyeShadesReflectance3 1 2 8 32 0 gt DYE 2 8 shade is absent Later DyeShadesReflectance31 2 9 1 20 DYE 2 9 shade is absent DyeShadesReflectance31 2 9 2 20 gt DYE 2 9 shade is absent DyeShadesReflectance3 1 2 9 3 0 gt DYE 2 9 shade is absent DyeShadesReflectance3 1 2 9 31 0 gt DYE 2 9 shade is absent DyeShadesReflectance3 1 2 9 32 0 gt DYE 2 9 shade is absent Later DyeShadesReflectance31 2 10 1 20 gt DYE 2 10 shade is absent DyeShadesReflectance31 2 10 2 20 gt DYE 2 10 shade is absent DyeShadesReflectance31 2 10 3 20 gt DYE 2 10 shade is absent DyeShadesReflectance31 2 10 31 2 0 gt DYE 2 10 shade is absent DyeShadesReflectance31 2 10 32 0 gt DYE 2 10
18. 855 47 985 61 9 69 215 72 28 73 26 73 54 73 71 74 085 74 455 74 56 74 56 74 485 74 335 74 285 74 295 74 255 74 295 74 395 74 495 74 56 74 615 74 635 74 7 For DYE 1 C 1 1 71 1 475 1 365 1 366 1 415 1 615 3 495 13 965 32 715 48 24 58 59 64 595 67 79 69 32 70 01 70 845 71 935 72 555 72 595 72 395 72 04 71 735 71 66 71 95 72 795 73 875 74 86 75 495 75 87 76 04 76 16 For DYE 2 C 0 0075 48 935 47 425 45 415 43 755 42 505 41 975 42 33 43 515 45 655 48 55 52 565 57 075 61 895 66 245 69 66 72 045 73 265 73 77 74 06 74 2 74 195 74 24 74 35 74 43 74 63 74 84 75 045 75 12 75 2 75 255 75 345 For DYE 2 C 0 01 26 76 23 17 20 21 18 2 16 92 16 405 16 705 17 745 19 795 22 69 27 12 33 01 40 75 49 285 57 51 64 465 69 365 72 135 73 385 73 935 74 165 74 345 74 525 74 6 74 815 75 035 75 175 75 285 75 335 75 41 75 48 For DYE 2 C 0 15 11 985 9 015 6 975 5 765 5 04 4 725 4 78 5 195 6 14 7 64 10 325 14 555 21 33 30 475 41 635 53 155 62 365 67 995 70 77 71 965 72 37 72 555 72 705 72 82 73 105 73 435 73 695 73 865 73 965 74 05 74 135 For DYE 2 C 0 5 4 955 3 49 2 645 2 21 1 99 1 89 1 91 2 035 2 33 2 85 3 985 6 135 10 435 17 445 27 84 40 74 53 245 62 335 67 495 69 975 70 965 71 445 71 725 71 825 71 965 72 095 72 23 72 395 72 51 72 585 72 64 66 For DYE 2 C 1 2 24 1 725 1 46 1 3
19. As String Returns 2 digit text as described follows 00 No metamerism 10 Metamerisim at horizontal Red Green axe The color is changing from red to green or green to red between specifed two light sources 01 Metamerisim at vertical Blue Yellow axe The color is changing from blue to yellow or yellow to blue between specifed two light sources 11 Metamerism on both horizontal and vertical axes Worst case Anyname CIELAB_METAMERISM_DIRECTION_CALCULATE 0 18 22 12 0 3 23 09 Mt Metamerism direction indicator will be returned via variable Mt The result will be 10 Anyname CIELAB_METAMERISM_DIRECTION_CALCULATE 0 18 22 12 0 3 23 09 Mt Metamerism direction indicator will be returned via variable Mt The result will be 00 64 Subroutine no Subroutine name Description Purpose General form Input parameters 33 REFLECTANCE31 RECIPE CALCULATE Calculates dyeing recipe for a color Send reflectance values of target color used substrate target substrate calibration shades number of dyes in a recipe and get all recipe alternatives in a specified text file REFLECTANCE31 RECIPE CALCULATE DyeShadesReflectance31 As Single ShadesSubstrateReflectance31 As Single TargetSubstrateReflectance31 As Single TargetColorReflectance31 As Single Prices As Single NumberOfDyesInEachRecipe As Integer OutputTextFileName As String Screen As Boolean InformationX As Integer
20. DLL You don t need to know how it is calculate ColorCalculationTreasures DLL will do it for you But we assume that you are also familiar with Color Management Terminology like color spaces indices assessments recipes calibration shades light sources observer metamerism and etc Note We have tested and used and still testing and using this DLL in Visual Basic 6 in our lab This does not mean that this DLL can only work with Visual Basic but informations on this manual may contain specific methods for Visual Basic programming languages such as variable declaration methods DLL referencing methods accessing DLL contents Auto Help issues etc What sort of instant functions does this DLL have This DLL has 2 types of functions in it These are a Color calculation functions b Spectrophotometers management functions What are these funtions There are 40 6 48 instant subroutines as listed here Each of these are ready to calculate values according to the parameters you supplied to them via your program source code as described later see Function Description Section of this document COLOR CALCULATION FUNCTIONS 40 pcs 1 REFLACTANCE40_CAPITALXYZ_CALCULATE 2 CIELab CAPITALXYZ CALCULATE 3 CAPITALXYZ LOWERCASExyz CALCULATE 4 REFLECTANCEA0 LOWERCASExyz CALCULATE 5 REFLECTANCEA0 CIELab CALCULATE 6 CIELab DELTA CALCULATE 7 REFLECTANCE40 HUNTERLab CALCULATE 8 HUNTER DELTA CALCULATE 9 REFLECTANCE40 CMC CALCULATE 10
21. InformationY As Integer Result NumberOfAlternatives As Integer Parameter 1 gt DyeShadesReflectance31 As Single Three dimensional array with boundaries 6 15 and 32 elements Another saying that an array defined as DyeShadesReflectance31 1 to 6 1 to 15 and 1 to 32 These three dimensional array is for shades reflectance values also known as calibration data with different concentrations C prepared in laboratory The format of this array is as follows First dimension 6 elements represents dye number Second dimension 15 elements represents calibration data number Third dimension 32 elements represent calibration data C value and its 31 elements reflectance values 400nm 700nm with 10nm intervals Filling this 3 dimensional array correctly is very critical to get good recipies To understand better let s assume a scenario as follows Scenerio Assume we have 5 dyes named DYE 1 DYE 2 DYE 3 DYE 4 and DYE 5 Each dye has calibration data as follows DYE 1 has 7 shades with different concentrations These are C 0 005 0 0075 0 01 0 05 0 1 0 5 and 1 0 DYE 2 has 5 shades with different concentrations These are C 0 0075 0 01 0 15 0 5 and 1 0 DYE 3 has 4 shades with different concentrations These are C 0 05 0 075 0 15 and 0 3 DYE 4 has 9 shades with different concentrations These are C 0 05 0 075 0 1 0 2 0 3 0 4 0 5 0 6 and 0 7 DYE 5 has 7 shades with different concentrations These are C
22. Later DyeShadesReflectance31 1 6 1 20 5 DyeShadesReflectance31 1 6 2 4 68 DyeShadesReflectance31 1 6 3 23 5 e gt DYE 1 6 shade concentration gt DYE 1 6 shade 400nm reflectance gt DYE 1 6 shade 410nm reflectance DyeShadesReflectance31 1 6 31 74 635 gt DYE 1 6 shade 690nm reflectance DyeShadesReflectance31 1 6 32 74 7 Later DyeShadesReflectance31 1 7 1 1 DyeShadesReflectance31 1 7 2 1 71 gt DYE 1 6 shade 700nm reflectance gt DYE 1 7 shade concentration gt DYE 1 7 shade 400nm reflectance DyeShadesReflectance31 1 7 3 1 475 gt DYE 1 7 shade 410nm reflectance e e DyeShadesReflectance31 1 7 31 2 76 04 gt DYE 1 7 shade 690nm reflectance DyeShadesReflectance31 1 7 32 2 76 16 Later DyeShadesReflectance31 1 8 1 20 DyeShadesReflectance31 1 8 2 20 DyeShadesReflectance31 1 8 3 20 e e DyeShadesReflectance31 1 8 31 2 0 DyeShadesReflectance31 1 8 32 2 0 Later DyeShadesReflectance31 1 9 1 20 DyeShadesReflectance31 1 9 2 20 DyeShadesReflectance31 1 9 3 20 DyeShadesReflectance31 1 9 31 2 0 DyeShadesReflectance31 1 9 32 0 Later DyeShadesReflectance31 1 10 1 20 DyeShadesReflectance31 1 10 2 20 DyeShadesReflectance31 1 10 3 20 e e DyeShadesReflectance31 1 10 31 2 0 DyeShadesReflectance31 1 10 32 0 gt DYE 1 7 shade 700nm reflectance gt DYE 1 8 shade is absent gt DYE 1 8 shade is absent gt DYE 1 8 shade is absent gt DYE 1
23. Too long text Max length is 240 characters 110 Subroutine no Subroutine name Desciption Purpose General form Input parameters 3 CALIBRATE_WHITE Performs white calibration Calibrating the instrument with white plate CALIBRATE_WHITE ComObject As Object ComPortNo As Byte Instrument As Byte WhitePlateNo As String As String Parameter 1 gt ComObject As Object Obejct full name of serial communication object Name of the MsComm object in the Form For example Assume that a form namely Form1 and a MsComm object on it namely MsComm1 In this case this parameter will be like this Form1 MsComml Parameter 2 s ComPortNo As Byte A number between 1 to 255 indicating port number of serial commnunication channel Parameter 3 gt Instrument As Byte A number indicating which instrument you use See SUPPORTED INSTRUMENT SELECTION TABLE at the end of this document Parametre 4 gt WhitePlateNo As String White plate serial no which is given with the instrument Output parameters Parameter 1 gt CALIBRATE WHITE As String Notes Examples The name of this function is the output parameter saying succesfully done or not If operation has been carried out succesfully then it will return a string as OKEY If operation is failed for any reason then it will return a string as FAIL with an explanation of reason of this failure If the instrument you use requires black
24. a string as FAIL with an explanation of reason of this failure If the instrument is a model requires black calibration then you need a accesory called black trap If the black calibration of the instrument is optinal but you don t have black trap and you wish to perform black calibration anyway then hold measurement view towards a darky place which has no obstacle in front of it min 2 5 meters range If black trap is not given with the instrument this does not mean it never requires black calibration It may be optional Examples ResultzAnyname2 CALIBRATE BLACK Form1 MSComml 2 3 3001714 KonicaMinolta 2500d will be calibrated with white plate with serial number 3001714 via MScomm object MsComm3 in the form Form1 using serial channel 2 If the command is executed succesfully then variable Result will return OKEY If it is not executed successfuly for a reason then it will return FAIL following by an explanation Example FAIL 11 Black amp white calibration is not ok 113 StatuscAnyname2 CALIBRATE BLACK Calibration MSComm3 2 12 XA7142 GretagMacbeth 700A will be calibrated with white plate with serial number XA7142 via MScomm object MsComm3 in the form Calibration using serial channel 2 If the command is executed succesfully then variable Result will return OKEY If it is not executed successfuly for a reason then it will return FAIL following by an explanation
25. and a MsComm object on it namely MsComm1 In this case this parameter will be like this Form1 MsComml Parameter 2 s ComPortNo As Byte A number between 1 to 255 indicating port number of serial commnunication channel Parameter 3 gt Instrument As Byte A number indicating which instrument you use See SUPPORTED INSTRUMENT SELECTION TABLE at the end of this document Parametre 4 gt Target RT As String Measurement mode to be applied 0 gt Reflectance measurement 1 gt Transmission measurement Each instrument has no Transmission mode If the specified instrument does not have such a feature then this parameter will be ignored automaticly Parametre 5 gt Target SCIE As String Defines specular component status 0 gt SCI specular component included qp SCE specular component excluded Each instrument has no SCI mode If the specified instrument does not have such a feature then this parameter will be ignored automaticly Parametre 6 gt Target View As String Sample measurement area selection 0 Large area view Medium area view 2 Small area view 3 Very small area view Each instrument can not support all these 4 modes If the instrument has only one view option then this parameter will be ignored automaticly If the instrument support more than one viewing mode but the view you specified is not supported by the instrument then function will return a failure information
26. at CIELab colorspace of the color Parameter 2 gt CIE a As Single a Red Green value at CIELab colorspace of the color Parameter 3 gt CIE L As Single b Blue Yellow value at CIELab colorspace of the color Parameter 4 gt LightSource As String One of the options from LIGHT SOURCES SELECTION REFERENCE TABLE at the end of this document to tell the subroutine which light source will be used simulated to calculate X Y Z tristimulus values Parameter 3 gt Observer as Byte One of the options below to tell the subroutine which observer for the specified light source will be used to calculate X Y Z tristimulus values 2 Weighing factors for 2 degree observer will be used 10 gt Weighing factors for 10 degree observer will be used Output parameters Parameter 1 gt Result Red As Single Returns a red value between 0 255 corresponding to the color given with L a and b CIELab values under a specified light source and observer Parameter 2 gt Result Green As Single Returns a green value between 0 255 corresponding to the color given with with L a and b CIELab values under a specified light source and observer Parameter 3 gt Result Blue As Single Returns a blue value between 0 255 corresponding to the color given with with L a and b CIELab values under a specified light source and observer Notes 3 Examples Anyname CIELab_RGB_CALCULATE 11 12 7 34 21 89 D65 10 Redl Green1 Bluel
27. back to you 106 Parametre 7 gt Target UV As String UV filter position adjustment Parameter UV filter position 0 UV components included 100 No UV filter S UV components excluded 400nm 2 UV components excluded 400nm low profile 3 UV components excluded 420nm a UV components excluded 420nm low profile 52 UV adjusted 400nm normal illumination 6 UV adjusted 400nm low illumination 7 UV adjusted 420nm normal illumination UV adjusted 420nm low illumination A UV excluded 100 Output parameters Parameter 1 gt SET INSTRUMENT As String The name of this function is the output parameter saying succesfully done or not If operation has been carried out succesfully then it will return a string as OKEY If operation is failed for any reason then it will return a string as FAIL with an explanation of reason of this failure Notes 1 When any changes occured on instrument status re calibrating is a must See CALIBRATE WHITE and CALIBRATE BLACK functions for more information about calibration the instrument 2 Each instrument does not support all UV modes If specified UV is unsupported UV mode for he instrument specified then function will return FAIL and following by the reason of the failure The UV modes comforms to instrument are listed in the table below Markas Model UV tipi Parametre Konica
28. be output via variables DiffL Diffa Diffb and DiffE Anyname CIELab DELTA CALCULATE 71 12 13 46 21 17 70 09 13 30 21 10 CIELab DL CIELab Da CIELab Db CIELab Da The differences between standard color L 71 12 a213 46 b 21 17 and trial color L 70 09 a 13 30 bz21 10 will be calculated and differences between these two colors will be output via variables CIELab DL CIELab Da CIELab Db and CIELab DE 18 Subroutineno 7 Subroutine name REFLECTANCEA40 HUNTERLab CALCULATE Description Calculates L a b values in HunterLab color space from reflectance values of a color Purpose Send reflectance values between 360nm 750nm with 10nm interval 40 pcs and get L a and b values for HunterLab color space General form REFLECTANCEA40 HUNTERLab CALCULA TE Reflectance40 As Single LightSource As String Observer As Byte Result Hunter L As Single Result Hunter a As Single Result Hunter b As Single Input parameters Parameter 1 gt Reflectance40 as Single Any array with 40 elements having reflectance values between 360nm 750nm with 10nm intervals Example Refs 1 212 345 Reflectance value for 360nm Refs 2 11 395 Reflectance value for 370nm Refs 39 32 123 Reflectance value for 740nm Refs 40 236 523 Reflectance value for 750nm Parameter 2 gt LightSource As String One of the options from LIGHT SOURCES SELECTION REFERENCE TABLE at the end of this document to tell the subroutine which light
29. case the function ignore that parameter if it has no effect on the instrument We recommend you to check instrument status by calling function INSTRUMENT STATUS after each use of SET INSTRUMENT function 103 4 All function in this chapter uses RS232 serial communication channel to communicate with the insturument Using serial port is different at each programming language Following method is for Visual Basic 6 as an example 1 Adding MsComm object into your project as follows a Select Project Components from menu in VB6 and find Microsoft Comm Control 6 0 and select 1t Components X Controls Designers Insertable Objects Messenger 1 0 Type Library MicroHelp Gauge Control MicroHelp Key State Control Microsoft ADO Data Control 6 0 SP6 OLEDB C Microsoft Agent Control 2 0 C Microsoft Chart Control Microsoft Chart Control 6 0 OLEDB I2EMicrosoft Comm Control 6 0 Microsoft Common Dialog Control 6 0 SP6 Microsoft Data Bound Grid Control 5 0 SP3 Microsoft Data Bound List Controls 6 0 Microsoft DataGrid Control 6 0 OLEDB Browse Microsoft DataList Controls 6 0 OLEDB gt Selected Items Only Microsoft Comm Control 6 0 Location C WINDOWS system32 M5COMM32 0CX iptal Uygula Figure 4 Sample object screen MScomm object adding If you do it correctly you will see a new object in Toolbox like in figure 5 N
30. color Parameter 9 gt CIE b2 Std As Single b value CIELab under second light source of the first color Parameter 10 5 CIE L2 Trial As Single L value CIELab under second light source of the second color Parameter 11 5 CIE a2 Trial As Single a value CIELab under second light source of the second color Parameter 12 gt CIE b2 Trial As Single b value CIELab under second light source of the second color 61 Output parameters Parameter 1 gt Result Metamerism As Single Returns metamerism index which shows how the difference between two colors is changing when the light source switched from LightSourcel to LightSource2 If Result Metamerism is equal to 1 then metamerism is perfect In another saying that color difference is not changing when the light source changed Be careful Metamerism 1 does not mean that the colors are not changing from one light source to another Metamerism 1 only means that the difference between two colors stay same from one light source to another Notes 1 As all output numeric parameters has decimal point be sure that the type of those parameters are defined properly in your source code In VB6 we use single declaration type to do it For example Dim VariableName as Single or Public VariableName as Single Examples Anyname CIELab METAMERISM CALCULATE 44 12 3 12 7 78 45 01 3 99 8 71 46 17 4 14 6 01 48 03 5 21 7 11 MetameriIndex Metamerism index showing difference ch
31. is 120 caharcter Cilas parametreleri Parametre 1 SHOW As String The name of this function is the output parameter saying succesfully done or not If operation has been carried out succesfully then it will return a string as OKEY If operation is failed for any reason then it will return a string as FAIL with an explanation of reason of this failure Notes This command is not supported by all instrtuments When this document printed the model was KonicaMinolta 2300d 2500d ve 2600d portable models Example Sonuc Anyname2 SHOW Form1 MSComml 2 3 1 Place the sample A message Place the sample with double sized character will be sent to KonicaMinolta 2500d s display by using serial channel 2 and MsComml object in the form Form1 109 If the command is executed succesfully then variable Result will return OKEY If it is not executed successfuly for a reason then it will return FAIL follwing by an explanation Example FAIL Too long text Max length is 120 characters StatuscAnyname2 SHOW Settings MSComm3 2 4 0 Hello A message Hello with normal sized character will be sent to KonicaMinolta 2600d s display by using serial channel 2 and MsComm3 object in the form Settings If the command is executed succesfully then variable Result will return OKEY If it is not executed successfuly for a reason then it will return FAIL follwing by an explanation Example FAIL
32. rnek FAIL 05 Lamp did not fire 114 Subroutine no 5 Subroutine name INSTRUMENT_STATUS Description Report all settings available on instruments Purpose Having information about the instrument current settings General form INSTRUMENT STATUS ComObject As Object ComPortNo As Byte Instrument As Byte As String Input parameters Parameter 1 gt ComObject As Object Obejct full name of serial communication object Name of the MsComm object in the Form For example Assume that a form namely Form1 and a MsComm object on it namely MsComm1 In this case this parameter will be like this Form1 MsComml Parameter 2 s ComPortNo As Byte A number between 1 to 255 indicating port number of serial commnunication channel Parameter 3 s Instrument As Byte A number indicating which instrument you use See SUPPORTED INSTRUMENT SELECTION TABLE at the end of this document Output parameters Parametre 1 gt INSTRUMENT STATUS The name of this function is the output parameter and returns a string with 38 characters Each character has a special meaning as follows 115 Starting Length Meaning Values character 1 4 characters Indicates that command FAIL gt Command could not performed successfuly performed successfuly or not OKEY gt Komut do ru bir ekilde islenemedi 5 character Seperator 6 1 character Indi
33. source will be used simulated to calculate Hunter L Hunter a and Hunter b values Parameter 3 gt Observer as Byte One of the options below to tell the subroutine which observer for the specified light source will be used to calculate Hunter L a and b values 2 Weighing factors for 2 degree observer will be used 10 gt Weighing factors for 10 degree observer will be used Output parameters Parameter 1 s Result Hunter L As Single Returns Lightness value L in Hunter coordinate system L value is between 0 and 100 100 represents lightest color and 0 zero represents darkest colors Parameter 2 gt Result Hunter a As Single Returns Greenish Redish value a in Hunter coordinate system Minus values represent green zone Plus values represent red zone Parameter 3 gt Result Hunter b As Single Returns Yellowish Blueish value b in Hunter coordinate system Minus values represent blue zone Plus values represent yellow zone 19 Notes 1 As all output numeric parameters has decimal point be sure that the type of those parameters are defined properly in your source code In VB6 we use single declaration type to do it For example Dim VariableName as Single Or Public VariableName as Single 2 Reflectance values are values This means that all values are between 0 and 100 3 Output parameters Result Hunter a and Result Hunter b may return plus or minus value so be sure that variable has been defined pr
34. subroutine Parameter 3 gt Lowercase 7 As Single Cromaticity z value of the color see NOTES Term 2 of this subroutine Output parameters Parameter 1 s Result TintGG As Single Ganz Griesser Tint value for the color given with chromaticity coordinates values lowercase x y and z Parameter 2 Result E313 As Single E313 Tint value for the color given with chromaticity coordinates values lowercase x y and z Notes 1 As all output numeric parameters has decimal point be sure that the type of those parameters are defined properly in your source code In VB6 we use single declaration type to do it For example Dim VariableName as Single Or Public VariableName as Single 2 TINT values are calculated under D65 and 10 degree observer Please be sure that chromaticity coordinates lowercase x y and z values supplied corresponds this principle Examples Anyname LOWERCASEXYZ_TINT_CALCULATE 0 18 0 32 0 41 Result_T1 Result_T2 TINT values for the color given with chromaticity coordinates values x 0 18 y 0 32 and z 0 41 will be output via variable Result_T1 Ganz Griesser and Result_T2 E313 Anyname LOWERCASEXYZ TINT CALCULATE 0 12 0 44 0 19 Result_TINT1 Result TINT2 TINT values for the color given with chromaticity coordinates values x 0 12 y 0 44 and z 0 19 will be output via variable Result TINT1 Ganz Griesser and Result TINT2 E313 44 Subroutine no 22 Subroutine name REFLECTANCE40
35. the color given with X Y Z tristimulus values Parameter 3 gt Result Blue As Single Returns a blue value between 0 255 corresponding to the color given with X Y Z tristimulus values Notes c Examples Anyname CAPITALXYZ_RGB_CALCULATE 11 12 7 34 21 89 Red1 Green1 Blue1 Three values between 0 and 255 will be returned via output variables Red1 Green1 Bluel for the color given with tristimulus values X 11 12 Y 7 34 and Z 21 89 Anyname REFLECTANCEA40 RGB CALCULATE 30 06 9 17 13 13 cR cG cB Three values between O and 255 will be returned via output variables cR cG cB for the color given with tristimulus values X 30 06 Y 9 17 and Z 13 13 33 Subroutine no 15 Subroutine name REFLECTANCE40 YELLOWNESS CALCULATE Description Calculates ASTMD1925 ASTME313 and BASFGB yellowness indices for the color given in array REFLECTANCEAO Purpose Send reflectance values between 360nm 750nm with 10nm intervals 40 pcs and get three type yellowness indices ASTMD1925 ASTME313 and BASFGB General form REFLECTANCE40_YELLOWNESS_CALCULATE Reflectance40 As Single Result ASTMD1925 As Single Result ASTME313 As Single Result BASFGB As Single Input parameters Parameter 1 gt Reflectance40 as Single Any array with 40 elements having reflectance values between 360nm 750nm with 10nm intervals Example Refs 1 12 345 Reflectance value for 360nm Refs 2 11 395 Reflectance value for 370nm Refs 39
36. then variable Result will return OKEY If it is not executed successfuly for a reason then it will return FAIL following by an explanation rnek FAIL 05 Lamp did not fire 112 Subroutine no A Subroutine no CALIBRATE BLACR Description Performs black calibrate Purpose Calibrating the instrument with black trap General form CALIBRATE BLACK ComObject As Object ComPortNo As Byte Instrument As Byte WhitePlateNo As String As String Giris parametreleri Parameter 1 gt ComObject As Object Obejct full name of serial communication object Name of the MsComm object in the Form For example Assume that a form namely Form1 and a MsComm object on it namely MsComm1 In this case this parameter will be like this Form1 MsComml Parameter 2 s ComPortNo As Byte A number between 1 to 255 indicating port number of serial commnunication channel Parameter 3 gt Instrument As Byte A number indicating which instrument you use See SUPPORTED INSTRUMENT SELECTION TABLE at the end of this document Parametre 4 gt WhitePlateNo As String White plate serial no which is given with the instrument Output parameters Notes Parameter 1 gt CALIBRATE BLACK As String The name of this function is the output parameter saying succesfully done or not If operation has been carried out succesfully then it will return a string as OKEY If operation is failed for any reason then it will return
37. 00nm TargetSubstrateReflectance3 1 2 91 395 Reflectance value for 410nm TargetSubstrateReflectance3 1 30 93 123 Reflectance value for 690nm TargetSubstrateReflectance3 1 3 1 96 523 Reflectance value for 700nm Important In order to get more precious recipe calculation the substrate should be processed as Blank Dyeing and then measured Blank dyeing means a dyeing process without dyestuff but also with same chemicals auxiliaries with calibration shades in same machine of calibration shades Because white substrate gets a little tint due to chemicals 90 Parameter 4 s TargetColorReflectance31 As Single An array with 31 elements having reflectance values between 400nm 700nm with 10nm intervals of the targeted color whose recipe will be calculated Example TargetColorReflectance3 1 1 82 345 Reflectance value for 400nm TargetColorReflectance3 1 2 91 395 Reflectance value for 410nm TargetColorReflectance31 30 293 123 Reflectance value for 690nm TargetColorReflectance3 1 31 96 523 Reflectance value for 700nm Parameter 5 gt NumberOfDyesInEachRecipe As Integer Represent how many dyes will be used for the each recipe which will be calculated It is between 1 and 6 but commonly 3 is used Another saying that you may pass up to 6 dyes and may wish to create many recipe alternatives with 3 dyes in each recipes Parameter 6 gt OutputTextFileName As String All calculated recipies is stored in a text fi
38. 1 Meaning Viewing area Lens position UV filter position Specular component position Measurement mode Instrument serial no White calibration plate no White calibration Siyah calibration Small Small Included 100 SCE Reflectance 180173004 180113004 Done ok Done ok If command can not performed successfuly then varibale Result will return such a string as below Example FAIL Time out Receiving data 117 Subroutine no 6 Subroutine name MEASURE Description To take a measurement Purpose To take a measurement with current status parameters General form MEASURE ComObject As Object ComPortNo As Byte Instrument As Byte Result MeasuredReflectance40 As String As String Input parameters Parameter 1 gt ComObject As Object Obejct full name of serial communication object Name of the MsComm object in the form For example Assume that a form namely Form1 and a MsComm object on it namely MsComm1 In this case this parameter will be like this Form1 MsComml Parameter 2 s ComPortNo As Byte A number between 1 to 255 indicating port number of serial commnunication channel Parameter 3 gt Instrument As Byte A number indicating which instrument you use See SUPPORTED INSTRUMENT SELECTION TABLE at the end of this document Output parameters Parametre 1 gt Result MeasuredReflectance40 As String An array consist of 40 elements for reflec
39. 1 3 12 2 20 DyeShadesReflectance31 3 12 3 20 DyeShadesReflectance31 3 12 31 2 0 DyeShadesReflectance31 3 12 32 0 Later DyeShadesReflectance31 3 13 1 20 DyeShadesReflectance31 3 13 2 20 DyeShadesReflectance31 3 13 3 20 DyeShadesReflectance31 3 13 31 2 0 DyeShadesReflectance31 3 13 32 2 0 Later DyeShadesReflectance31 3 14 1 20 DyeShadesReflectance31 3 14 2 20 DyeShadesReflectance31 3 14 3 20 DyeShadesReflectance31 3 14 31 2 0 DyeShadesReflectance31 3 14 32 0 Later DyeShadesReflectance31 3 15 1 20 DyeShadesReflectance31 3 15 2 20 DyeShadesReflectance31 3 15 3 20 DyeShadesReflectance31 3 15 31 2 0 DyeShadesReflectance31 3 15 32 2 0 DYE 3 12 shade is absent gt DYE 3 12 shade is absent gt DYE 3 12 shade is absent gt DYE 3 12 shade is absent DYE 3 12 shade is absent DYE 3 13 shade is absent DYE 3 13 shade is absent gt DYE 3 13 shade is absent gt DYE 3 13 shade is absent DYE 3 13 shade is absent gt DYE 3 14 shade is absent gt DYE 3 14 shade is absent gt DYE 3 14 shade is absent gt DYE 3 14 shade is absent gt DYE 3 14 shade is absent gt DYE 3 15 shade is absent DYE 3 15 shade is absent gt DYE 3 15 shade is absent gt DYE 3 15 shade is absent gt DYE 3 15 shade is absent DYE 3 shades placement into the array has been done Now let s continue with DYE 4 78 DyeShadesReflectance31 4 1 1 20 05 gt DYE 4 1 shade co
40. 2 32 1 885 1 595 1 455 1 395 1 37 1 38 1 435 1 81 3 655 9 28 20 13 34 105 47 175 57 62 945 66 29 68 29 69 795 71 065 71 92 72 36 72 635 For DYE 4 C 0 7 29 735 22 95 16 84 12 295 8 785 6 4 4 795 3 705 2 865 2 285 1 875 1 665 1 58 1 545 1 545 1 64 2 24 4 63 11 155 22 62 35 785 45 91 51 395 54 26 57 325 61 415 65 645 68 99 71 315 72 65 73 445 For DYE 5 C 0 01 56 98 59 625 61 255 62 485 63 39 64 465 65 67 66 855 67 795 68 65 69 265 69 025 67 98 66 29 63 88 61 03 57 99 54 505 50 33 45 865 42 715 41 585 40 445 38 225 36 605 38 115 46 01 61 305 78 485 90 035 94 02 For DYE 5 C 0 05 51 47 53 62 53 965 53 94 53 925 54 985 57 07 59 015 60 41 61 71 62 2 60 87 57 70 53 665 48 655 43 38 38 535 33 76 28 575 23 6 20 44 19 465 18 48 16 505 15 135 16 53 23 5 38 465 60 7 83 785 99 195 For DYE 5 C 0 1 48 06 49 9 49 35 48 555 47 885 48 895 51 37 53 54 55 105 56 355 56 44 54 25 50 045 44 815 38 91 33 155 28 235 23 65 18 92 14 66 12 135 11 4 10 69 9 25 8 34 9 6 15 155 27 305 46 93 70 625 90 2 For DYE 5 C 0 15 43 635 45 3 44 295 43 045 42 175 43 195 45 91 48 27 49 965 51 3 51 25 48 72 44 06 38 485 32 385 26 65 21 99 17 805 13 68 10 13 8 125 7 595 7 11 6 05 5 39 6 38 10 71 20 45 37 205 59 31 79 97 For DYE 5 C 0 3 38 2 39 51 37 69 35 79 34 375 35 15 37 945 40 465 42 185
41. 25 16 1 Opct Opacity according to tristimulus X value of the color specified with tristimulus X Y Z over white and over black will be output via variable opacity 53 Subroutine no 27 Subroutine name REFLECTANCE40_STRENGTH_CALCULATE Description Calculates 3 types strengths Chromatic Apparent and Integrated relatively to a color Purpose Send two sets of reflectance values between 360nm 750nm with 10nm interval 40 pcs for two colors and get one s Trail strength value relative to the other standard General form REFLECTANCEA40 STRENGTH CALCULATE Reflectance40 Std As Single Reflectance40 Trial As Single Result ChromaticStrength As Single Result ApperentStrength As Single Result IntegratedStrength As Single Input parameters Parameter 1 gt Reflectance40 Std As Single An array with 40 elements having reflectance values between 360nm 750nm with 10nm intervals of the color assuming standard Example Refs 1 212 345 Reflectance value for 360nm Refs 2 11 395 Reflectance value for 370nm Refs 39 32 123 Reflectance value for 740nm Refs 40 236 523 Reflectance value for 750nm Parameter 2 gt Reflectance40 Trial As Single An array with 40 elements having reflectance values between 360nm 750nm with 10nm intervals of the color assuming trial Example Refs 1 211 345 Reflectance value for 360nm Refs 2 14 39 Reflectance value for 370nm Refs 39 29 16 Reflectance value for 740nm Refs 40 2
42. 34 895 30 485 26 735 23 615 20 505 17 77 15 325 13 615 12 7 12 24 12 275 13 64 18 075 27 1 40 145 53 365 62 745 67 745 70 07 71 15 72 015 72 835 73 54 74 02 74 33 74 475 74 62 For DYE 4 C 0 1 47 435 44 16 39 41 34 525 29 69 25 5 22 02 19 175 16 38 13 98 11 865 10 43 9 685 9 3 9 315 10 45 14 27 22 335 34 785 48 54 59 32 65 795 69 04 70 57 71 49 72 2 72 835 73 27 73 555 73 735 73 875 For DYE 4 C 0 2 40 4 35 33 29 54 24 375 19 78 16 07 13 175 10 955 8 895 7 235 5 905 5 03 4 615 4 41 4 425 5 045 7 405 13 295 23 84 36 785 47 105 52 265 53 905 55 055 57 71 61 725 65 9 69 255 71 495 72 705 73 4 For DYE 4 C 0 3 37 24 31 345 25 2 19 96 15 555 12 16 9 65 7 785 6 15 4 91 3 935 3 33 3 05 2 925 2 99 3 255 4 865 9 405 18 895 32 68 46 635 57 205 63 825 67 345 69 23 70 415 71 28 71 855 72 28 72 5 72 68 67 For DYE 4 C 0 4 33 31 27 015 20 9 15 99 12 04 9 1 7 01 5 52 4 265 3 365 2 68 2 265 2 095 2 025 2 025 2 25 3 315 6 74 14 78 27 675 41 85 53 39 61 65 115 67 245 68 56 69 75 70 855 71 615 71 95 72 15 For DYE 4 C 0 5 32 15 25 395 19 105 14 29 10 49 7 82 6 03 4 84 3 845 3 09 2 545 2 235 2 105 2 035 2 04 2 19 3 065 6 12 13 79 26 62 41 16 53 295 61 455 65 98 68 495 70 12 71 37 72 35 73 01 73 345 73 565 For DYE 4 C 0 6 26 97 20 28 14 49 10 3 7 2 5 15 3 82 2 96
43. 35 43 Reflectance value for 750nm Output parameters Parameter 1 s Result ChromaticStrength As Single Returns Chromatic strength value of trial color relative to standard color assumed as 100 Parameter 2 gt Result ApparentStrength As Single Returns Apparent strength value of trial color relative to standard color assumed as 100 Parameter 3 gt Result IntegratedStrength As Single Returns Integrated strength value of trial color relative to standard color assumed as 100 Notes 1 As all output numeric parameters has decimal point be sure that the type of those parameters are defined properly in your source code In VB6 we use single declaration type to do it For example 54 Dim VariableName as Single Or Public VariableName as Single 2 Reflectance values are values This means that all values are between 0 to 100 Examples Anyname REFLECTANCE40 STRENGTH CALCULATE Color Refs Coor2Refs Cst ASt Ist Cst Chromatic strength Ast Apparent strength and Ist Integrated strength of the color given in array Color1Refs relative to the color given in array Color2Refs will be output Anyname REFLECTANCE40 STRENGTH CALCULATE Shadel Shade2 Crmst AppSt Intst Crmst Chromatic strength Appst Apparent strength and Intst Integrated strength of the color given in array Shadel relative to the color given in array Shade2 will be output 55 Subroutine no 25 Subroutine name REFLECTANCE40_BRIGHTNES
44. 4 8 shade concentration gt DYE 4 8 shade concentration 80 Later DyeShadesReflectance31 4 9 1 20 7 DyeShadesReflectance31 4 9 2 229 735 DyeShadesReflectance31 4 9 3 222 95 DyeShadesReflectance31 4 9 31 2 72 65 DyeShadesReflectance3 1 4 9 32 73 445 Later DyeShadesReflectance31 4 10 1 20 DyeShadesReflectance31 4 10 2 20 DyeShadesReflectance31 4 10 3 20 DyeShadesReflectance31 4 10 31 2 0 DyeShadesReflectance31 4 10 32 0 Later DyeShadesReflectance31 4 11 1 20 DyeShadesReflectance31 4 11 2 20 DyeShadesReflectance31 4 11 3 20 DyeShadesReflectance31 4 11 31 2 0 DyeShadesReflectance31 4 11 32 2 0 Later DyeShadesReflectance31 4 12 1 20 DyeShadesReflectance31 4 12 2 20 DyeShadesReflectance31 4 12 3 20 DyeShadesReflectance31 4 12 31 2 0 DyeShadesReflectance31 4 12 32 0 DYE 4 9 shade concentration DYE 4 9 shade concentration DYE 4 9 shade concentration gt DYE 4 9 shade concentration DYE 4 9 shade concentration gt DYE 4 10 shade is absent gt DYE 4 10 shade is absent gt DYE 4 10 shade is absent gt DYE 4 10 shade is absent gt DYE 4 10 shade is absent gt DYE 4 11 shade is absent gt DYE 4 11 shade is absent gt DYE 4 11 shade is absent gt DYE 4 11 shade is absent gt DYE 4 11 shade is absent gt DYE 4 12 shade is absent gt DYE 4 12 shade is absent gt DYE 4 12 shade is absent gt DYE 4 12 shade is absent DYE 4 12 sh
45. 6 1 335 1 285 1 3 1 31 1 375 1 5 1 835 2 71 5 015 9 62 17 85 29 87 43 58 55 31 63 105 67 29 69 095 69 905 70 44 70 79 71 235 71 645 71 945 72 125 72 25 72 355 72 475 For DYE 3 C 0 05 39 68 37 33 88 31 125 28 57 26 56 25 02 23 985 23 275 23 06 23 225 23 675 24 655 26 1 28 165 31 085 34 88 39 355 44 45 49 91 55 14 59 8 63 77 66 875 69 455 71 515 73 035 73 98 74 585 74 925 75 16 For DYE 3 C 0 075 36 75 33 345 29 745 26 62 23 84 21 73 20 14 19 08 18 41 18 15 18 26 18 7 19 61 20 97 22 94 25 735 29 42 33 875 39 015 44 655 50 245 55 44 60 035 63 62 66 41 68 53 70 1 71 17 71 86 72 215 72 455 For DYE 3 C 0 15 27 47 23 68 20 095 17 26 14 89 13 16 11 92 11 115 10 6 10 41 10 495 10 805 11 475 12 525 14 065 16 325 19 52 23 64 28 78 34 915 41 58 48 365 54 92 60 485 65 05 68 61 71 115 72 74 73 775 74 33 74 7 For DYE 3 C 0 3 20 065 16 115 12 805 10 365 8 485 7 215 6 335 5 78 5 455 5 335 5 385 5 57 6 025 6 735 7 85 9 545 12 04 15 5 20 125 26 32 85 40 29 48 54 995 60 945 65 67 69 035 71 245 72 66 73 43 73 92 For DYE 4 C 0 05 51 15 49 665 46 43 42 55 38 28 34 22 30 65 27 575 24 395 21 56 18 97 17 12 16 14 15 635 15 71 17 29 22 17 31 415 43 79 55 47 63 175 67 015 68 715 69 56 70 325 71 11 71 825 72 31 72 635 72 79 72 945 For DYE 4 C 0 075 51 12 48 85 44 485 39 785
46. 6 11 31 2 0 DyeShadesReflectance31 6 11 32 0 Later DyeShadesReflectance31 6 12 1 20 DyeShadesReflectance31 6 12 2 20 DyeShadesReflectance31 6 12 3 20 DyeShadesReflectance31 6 12 31 2 0 DyeShadesReflectance31 6 12 32 2 0 Later DyeShadesReflectance31 6 13 1 20 DyeShadesReflectance31 6 13 2 20 DyeShadesReflectance31 6 13 3 20 DyeShadesReflectance31 6 13 31 2 0 DyeShadesReflectance31 6 13 32 2 0 Later DyeShadesReflectance31 6 14 1 20 DyeShadesReflectance31 6 14 2 20 DyeShadesReflectance31 6 14 3 20 DyeShadesReflectance31 6 14 31 2 0 DyeShadesReflectance31 6 14 32 0 gt DYE 6 11 shade is absent gt DYE 6 11 shade is absent gt DYE 6 11 shade is absent gt DYE 6 11 shade is absent gt DYE 6 11 shade is absent gt DYE 6 12 shade is absent gt DYE 6 12 shade is absent gt DYE 6 12 shade is absent gt DYE 6 12 shade is absent gt DYE 6 12 shade is absent gt DYE 6 13 shade is absent gt DYE 6 13 shade is absent gt DYE 6 13 shade is absent gt DYE 6 13 shade is absent gt DYE 6 13 shade is absent gt DYE 6 14 shade is absent gt DYE 6 14 shade is absent gt DYE 6 14 shade is absent gt DYE 6 14 shade is absent gt DYE 6 14 shade is absent 89 Later DyeShadesReflectance31 6 15 1 20 gt DYE 6 15 shade is absent DyeShadesReflectance31 6 15 2 20 gt DYE 6 15 shade is absent DyeShadesReflectance31 6 15 3 20 gt DYE 6 15 shade is absen
47. 6 523 Reflectance value for 750nm Parameter 2 gt Reflectance40 OverWhite As Single An array with 40 elements having reflectance values between 360nm 750nm with 10nm intervals of the sample over white Example Refs 1 219 345 Reflectance value for 360nm Refs 2 21 395 Reflectance value for 370nm Refs 39 42 123 Reflectance value for 740nm Refs 40 56 523 Reflectance value for 750nm Parameter 3 gt LightSource As String One of the options from LIGHT SOURCES SELECTION REFERENCE TABLE at the end of this document to tell the subroutine which light source will be used simulated to calculate opacity Parameter 4 gt Observer as Byte One of the options below to tell the subroutine which observer for the specified light source will be used for calculation 2 Weighing factors for 2 degree observer will be used 10 gt Weighing factors for 10 degree observer will be used Parameter 5 s OpacityType As Byte One of the options below determining opacity type 50 Type Meaning 1 Opacity at maximum value 2 Opacity according to tristimulus Z Suitbale for blue colors 3 Opacity according to tristimulus Y Suitable for green color 4 Opacity according to tristimulus X Suitable for yellow red colors 5 opacity integrated Suitable for general purposes Output parameters Parameter 1 gt Result Opacity As Single Returns opacity value Notes 1 As all output numeric parameters has decimal point be sur
48. 775K CIE avarage daylight Usefull for metamerism evaluation CWF Cool white White flouresance 4150K Also known F2 in USA Home amp store illumination D50 Daylight in North 5000K Used for metamery and general purpose of color evaluation D65 Avarage common daylight in North 6500K Used for metamery and general purpose of color evaluation General standart in Europe and Japan D75 Daylight in North 5000K Used for metamery and general purpose of color evaluation Suitable for opaque samples at ASTM D1729 standarts U30 Ultralume30 3000K Also known as F12 in USA or TL83 TL83 Philips TL83 3000K Also known as U30 ve F12 in USA Used in general Europe and pacific TL84 Philips TL84 4100K Also known as F11 in USA Used in general Europe and pacific F2 Wide band flouresance 4150K Similar to CWF Usefull for metamery testing Used in USA home and store illumination BT Wide band flouresance 6500K Similar to D65 and usefull for metamery testing Represents flouresance illumination in USA F11 Philips TL84 4000K Similar to ultralume40 Usefull for metamery testing Represents USA narrow band flouresance illumination NBF11 Narrow band flouresance Usefull for metamery testing Represents USA narrow band flouresance illumination SUPPORTED INSTRUMENT SELECTION TABLE Paramet
49. 8 shade is absent gt DYE 1 8 shade is absent gt DYE 1 9 shade is absent gt DYE 1 9 shade is absent gt DYE 1 9 shade is absent gt DYE 1 9 shade is absent gt DYE 1 9 shade is absent gt DYE 1 10 shade is absent gt DYE 1 10 shade is absent gt DYE 1 10 shade is absent gt DYE 1 10 shade is absent gt DYE 1 10 shade is absent 70 Later DyeShadesReflectance31 1 11 1 20 DyeShadesReflectance31 1 11 2 20 DyeShadesReflectance31 1 11 3 20 e e DyeShadesReflectance31 1 11 31 0 DyeShadesReflectance31 1 11 32 2 0 Later DyeShadesReflectance31 1 12 1 20 DyeShadesReflectance31 1 12 2 20 DyeShadesReflectance31 1 12 3 20 e e DyeShadesReflectance31 1 12 31 2 0 DyeShadesReflectance31 1 12 32 2 0 Later DyeShadesReflectance31 1 13 1 20 DyeShadesReflectance31 1 13 2 20 DyeShadesReflectance31 1 13 3 20 e e DyeShadesReflectance31 1 13 31 2 0 DyeShadesReflectance31 1 13 32 2 0 Later DyeShadesReflectance31 1 14 1 20 DyeShadesReflectance31 1 14 2 20 DyeShadesReflectance31 1 14 3 20 e e DyeShadesReflectance31 1 14 31 0 DyeShadesReflectance31 1 14 32 2 0 Later DyeShadesReflectance31 1 15 1 20 DyeShadesReflectance31 1 15 2 20 DyeShadesReflectance31 1 15 3 20 e e DyeShadesReflectance31 1 15 31 0 DyeShadesReflectance31 1 15 32 2 0 gt DYE 1 11 shade is absent gt DYE 1 11 shade is absent gt DYE 1 11 shade is absent gt DYE 1 11 shade
50. 8 7 means b value under first light source of the second color 46 17 means L value under second light source of the first color 62 14 14 means a value under second light source of the first color 26 01 means b value under second light source of the first color 48 03 means L value under second light source of the second color 15 21 means a value under second light source of the second color 27 11 means b value under second light source of the second color 63 Subroutine no Subroutine name Description Purpose General form Input parameters 32 CIELab_METAMERISM_DIRECTION_CALCULATE Detects metamerism direction according to the position of two colors in ab axes Send L a b values in CIELab color space for two colors and see both colors is at same region or not at ab axes of CIELab color space CIELAB_METAMERISM_DIRECTION_CALCULATE CIE_al As Single CIE_b1 As Single CIE_a2 As Single CIE_b2 As Single Result_Metamerism As String Parameter 1 gt CIE 21 As Single a value CIELab under first light source of the first color Parameter 2 gt CIE bl As Single Parameter 3 gt Parameter 4 gt b value CIELab under second light source of the first color CIE_a2 As Single a value CIELab under first light source of the second color CIE b1 As Single b value CIELab under second light source of the second color Output parameters Parameter 1 gt Notes Examples Result_Metamerism
51. APITAL Y As Single Tristimulus Y value of the color Parameter 3 gt CAPITAL Z As Single Tristimulus Z value of the color Parameter 4 gt LightSource As String One of the options from LIGHT SOURCES SELECTION REFERENCE TABLE at the end of this document to tell the subroutine which light source will be used simulated to calculate brightness values Parameter 5 gt Observer as Byte One of the options below to tell the subroutine which observer for the specified light source will be used for calculation 2 Weighing factors for 2 degree observer will be used 10 gt Weighing factors for 10 degree observer will be used Output parameters Parameter 1 gt Result CIE L As Single Returns Lightness value L in CIE coordinate system L value is between 0 to 100 100 represents lightest color and 0 zero represents darkest colors Parameter 2 gt Result CIE a As Single Returns Greenish Redish value a in CIE coordinate system Minus values represent green zone Plus values represent red zone Parameter 3 gt Result CIE b As Single Returns Yellowish Blueish value b in CIE coordinate system Minus values represent blue zone Plus values represent yellow zone Notes 1 As all output numeric parameters has decimal point be sure that the type of those parameters are defined properly in your source code In VB6 we use single declaration type to do it For example Dim VariableName as Single Or Public VariableNam
52. C_b As Single Returns Yellowish Blueish value b in CMC coordinate system Minus values represent blue zone Plus values represent yellow zone Parameter 4 gt Result_CMC_C As Single Returns chroma value C Duller Sharper in CMC coordinate system Parameter 5 gt Result_CMC_H As Single Returns Hue value H in Pureness CMC coordinate system Notes 1 As all output numeric parameters has decimal point be sure that the type of those parameters are defined properly in your source code In VB6 we use single declaration type to do it For example 25 Dim VariableName as Single Or Public VariableName as Single 2 Reflectance values are values This means that all values are between 0 and 100 3 Output parameters Result Result CMC a Result CMC b and Result CMC H may return plus or minus value so be sure that variable has been defined properly in your code Examples Anyname CIELab CMC CALCULATE 44 23 0 91 7 56 Result_L Result a Result b Result C Result H L a b C and H values of CMC color space will be returned via variables Result L Result a Result b Result C and Result H consecutively Anyname CIELab CMC CALCULATE 71 65 1 13 7 01 CMC L CMC a CMC b CMC C CMC H L a b C H values of CMC color space will be returned via variables CMC L CMC a CMC b CMC C and CMC H consecutively 26 Subroutine no 11 Subroutine name CMC DELTA CALCULATE Description Calculate
53. ColorLalculation Treasures Version 090927 2006 by Artoksi Don t think you can not succeed Be independent Let everybody to create his her own Lolor Matching Softwares featured not only quality control but also recipe prediction Furthermore softwares which can communicate with your spectrophotometer What else including an open source code showing all functionality of this DLL Engineering Art Center www artoksi com 1 What is ColorCalculationTreasures DLL 2 3 As the name explains simply this is a treasure consist of many instant functions on color calculation issues used by professional programmers on color matching software including recipe prediction Technically I wrote all essential functions for a color matching software and packed it as DLL for common use The user can easily create his her own Color Matching software including recipe calculations by calling the subroutines in this DLL as described in this manual It is not necessary to know about color matching principals understanding formulas techniques standards etc Just pass your input values to subroutine and get the output values in variable you declared in your source code That s all Note This manual only describes how to use this DLL in your source code and assumes that you are familiar with programming language issues Note As we said above everybody can create professional color matching software with this
54. F2 Staining Anyname REFLECTANCEA40 GRAY SCALE CALCULATE BeforeTest AfterTest D65 10 WashF StainingF Wash fastness and staining grade will be calculated according to the differences under illuminant Daylight 6500K and 10 degree observer of two colors given in Array BeforeTest and AfterTest and grades will be returned via variables WashF Wash and StainingF Staining 46 Subroutine no 23 Subroutine name CIELab GRAY SCALE CALCULATE Description Calculates Gray Scale rating factors for wash fastness and staining of a color Purpose Send CIELab L a and b values for both before test and after test samples and get wash fastness and staining rating between 1 and 5 General form CIELab GRAY SCALE CALCULATE CIE L Std As Single CIE a Std As Single CIE b Std As Single CIE L Trial As Single CIE a Trial As Single CIE b Trial As Single Result A02WashFastness As String Result AO3Staining As String Input parameters Parameter 1 gt CIE L Std As Single L value in CIELab color space for the sample before test process washing test for wash fastness or crockmeter test for staining Parameter 2 gt CIE a Std As Single a value in CIBLab color space for the sample before test process washing test for wash fastness or crockmeter test for staining Parameter 3 gt CIE b Std As Single b value in CIELab color space for the sample before test process washing test for wash fastness or crockmeter test for sta
55. GRAY SCALE CALCULATE Description Calculates Gray Scale rating factor for wash fastness and staining of a color Purpose Send reflectance values between 360nm 750nm with 10nm interval 40 pcs and get wash fastness and staining ratings between 1 and 5 General form REFLECTANCE40 GRAY SCALE CALCULATE Reflectance40 Std As Single Reflectance40 Trial As Single LightSource As String Observer As Byte Result A02WashFastness As String Result A03Staining As String Input parameters Parameter 1 gt Reflectance40 Std as Single An array with 40 elements having reflectance values between 360nm 750nm with 10nm intervals of the sample before test process washing test for wash fastness or crockmeter test for staining Example Refs 1 212 345 Reflectance value for 360nm Refs 2 11 395 Reflectance value for 370nm Refs 39 32 123 Reflectance value for 740nm Refs 40 36 523 Reflectance value for 750nm Parameter 2 gt Reflectance40 Trial as Single An array with 40 elements having reflectance values between 360nm 750nm with 10nm intervals of the sample after test process washing test for wash fastness or crockmeter test for staining Example Refs 1 211 245 Reflectance value for 360nm Refs 2 12 695 Reflectance value for 370nm Refs 39 33 173 Reflectance value for 740nm Refs 40 32 423 Reflectance value for 750nm Parameter 3 gt LightSource As String One of the options from LIGHT SOURCES SELECTION REFE
56. Integer An integer between 1 to 699 which represent memory adress of the instrument s memory location used for uploading Parameter 5 gt ColorName as String Specify the name of the color you wish to see on instruments Parameter 6 gt Reflectance40 as Single The corresponding values of the color to be uploaded Notes 1 This function is valid only for some models which has memory of KonicaMinolta These instruments are CM2300d CM2500c CM2500d ve CM2600d 2 Because of each memory location can be set for a different condition settings the data to be uploaded should match the setting of target memory location For example if the memory location 12 is set to L a b type of data you can not upload reflectance values In such a case you get an error Example Result Upload Form1 MSComm1 3 4 12 Yellow A1 Values The values in VALUES array is sent to memory location 12 of the instrument 2600d via serial port 3 of MScomml object on Forml If the process is successfull then Result variable return OKEY Sonuc OLDU olarak geri d ner The values in VALUES array must be compatible with the setting of memory location 12 See Notes 2 above for more information 123 LIGHT SOURCE SELECTION TABLE Parameter value Description A Incandencent A Tungsten 2856K Home amp store illumination Usefull for metamerism evaluation C Daylight Halogen 6
57. Minolta CM2300d No UV mode P4 CM2500c No UV mode p CM2600d UV included 96100 0 UV excluded el d UV adjusted E CM3220d No UV mode d CM3600d UV included 96100 0 UV excluded 400nm SEU UV excluded 400nm low profile 227 UV excluded 420nm 3 UV excluded 420nm low profile A UV adjusted 400nm normal illumination 5 UV adjusted 400nm low illumination 6 UV adjusted 420nm normal illumination 77 UV adjusted 420nm low illumination 8 CM3700d is being prepared GretagMacbeth CE2180 is being prepared i CE2180UV is being prepared CE3100 is being prepared CE7000 is being prepared CE7000A is being prepared 107 Examples ResultzAnyname SET INSTRUMENT Form1 MSComml 2 6 0 1 2 0 KonicaMinolta 3600d will be set to Reflectance SCE small view and UV included mode by using serial channel 2 via MsComml1 object in the form Form1 If the command is executed succesfully then variable Result will return OKEY If it is not executed successfuly for a reason then it will return FAIL follwing by an explanation Example FAIL Target UV parameter is wrong StatuszAnyname SET INSTRUMENT Settings MSComm3 2 12 0 0 1 07 GretagMacbeth CE7000 will be set up to reflectance SCE medium view and UV included mode by using serial channel 2 via MsComm3 object in
58. Minus values represent blue zone Plus values represent yellow zone 15 Notes 1 As all output numeric parameters has decimal point be sure that the type of those parameters are defined properly in your source code In VB6 we use single declaration type to do it For example Dim VariableName as Single Or Public VariableName as Single 2 Reflectance values are values This means that all values are between 0 to 100 3 Output parameters Result CIE a and Result CIE b may return plus or minus value so be sure that variable has been defined properly in your code Examples Anyname REFLECTANCE40_CIELab_CALCULATE RedTT 100 D65 10 Result L Result a Result b L a b values of CIELab color space under illuminant Daylight 6500K and 10 degree observer of the color in Array RedTT10 will be returned via variables Result L Result a and Result b consecutively Anyname REFLECTANCEA0 CIELab CALCULATE Sample 10 U30 10 CIELab L CIELab a CIELab b L a b values of CIELab color space under illuminant Ultralume 30 3000K and 10 degree observer of the color in array Samplel will be returned via variables CIELab L CIELab a and CIELab b consecutively 16 Subroutine no 6 Subroutine name CIELab DELTA CALCULATE Description Calculates Delta L DELTA a DELTA b and DELTA E values in CIE coordinate system from two sets of color Sample Standard vs Trial reflectance values Purpose Send L CIELab a CIELab a
59. RENCE TABLE at the end of this document to tell the subroutine which light source will be used simulated to calculate Gray Scale Ratings Parameter 4 gt Observer as Byte One of the options below to tell the subroutine which observer for the specified light source will be used for calculation 2 Weighing factors for 2 degree observer will be used 10 gt Weighing factors for 10 degree observer will be used 45 Output parameters Parameter 1 s Result A02VVashFastness As String Returns Wash Fastness grade between 1 and 5 Parameter 2 gt Result A03Staining As String Returns Staining grade between 1 and 5 Notes 1 As all output numeric parameters has decimal point be sure that the type of those parameters are defined properly in your source code In VB6 we use single declaration type to do it For example Dim VariableName as Single or Public VariableName as Single 2 Reflectance values are values This means that all values are between 0 to 100 3 Output parameters are in string format so be sure that variable has been defined properly in your code Examples Anyname REFLECTANCEA40 GRAY SCALE CALCULATE WhiteFabric Dyedfabric D65 10 F1 F2 Wash fastness and staining grade will be calculated according to the differences under illuminant Daylight 6500K and 10 degree observer of two colors given in Array WhiteFabric and Dyedfabric and grades will be returned via variables F1 Wash and
60. S_CALCULATE Description Calculates 2 types brightness value Z and R457 Purpose Send reflectance values between 360nm 750nm with 10nm interval 40 pcs and get brightness values Z and R457 General form REFLECTANCE40_BRIGHTNESS_CALCULATE Reflectance40 As Single LightSource As String Observer As Byte Result Brightness Z As Single Result Brightness R457 As Single Input parameters Parameter 1 gt Reflectance40 As Single An array with 40 elements having reflectance values between 360nm 750nm with 10nm intervals of the color Example Refs 1 212 345 Reflectance value for 360nm Refs 2 11 395 Reflectance value for 370nm Refs 39 32 123 Reflectance value for 740nm Refs 40 236 523 Reflectance value for 750nm Parameter 2 gt LightSource As String One of the options from LIGHT SOURCES SELECTION REFERENCE TABLE at the end of this document to tell the subroutine which light source will be used simulated to calculate brightness values Parameter 3 gt Observer as Byte One of the options below to tell the subroutine which observer for the specified light source will be used for calculation 2 Weighing factors for 2 degree observer will be used 10 gt Weighing factors for 10 degree observer will be used Output parameters Parameter 1 gt Result Brightness Z As Single Returns under specified light source and observer Z brightness value of the color given in array Reflectance40 Parameter 2 gt Resul
61. Z As Single Result_Lowercase_x As Single Result_Lowercase_y As Single Result_Lowercase_z As Single Input parameters Parameter 1 gt CAPITAL_X As Single Tristimulus X value of the color Parameter 2 gt CAPITAL_Y As Single Tristimulus Y value of the color Parameter 3 gt CAPITAL_Z As Single Tristimulus Z value of the color Output parameters Parameter 1 gt Result_Lowercase_x Returns x chromaticity value Parameter 2 gt Result_Lowercase_y Returns y chromaticity value Parameter 3 gt Result_Lowercase_z Returns z chromaticity value Notes As all output numeric parameters has decimal point be sure that the type of those parameters are defined properly in your source code In VB6 we use single declaration type to do it For example Dim VariableName as Single or Public VariableName as Single Examples Anyname CAPITALXYZ LOWERCASExyz CALCULATE 12 234 5 12 7 35 Resultx Resulty Resultz X y Z chromaticity values for the color specified with X Y Z tristimulus values will be returned via variables Resultx Resulty and Resultz consecutively Anyname CAPITALXYZ LOWERCASExyz CALCULATE 61 17 75 09 17 55 Chrtst x Chrtst y Chrtst z X y Z chromaticity values for the color specified with X Y Z tristimulus values will be returned via variables Chrtst x Chrtst y and Chrtst z consecutively 12 Subroutine no 4 Subroutine name REFLECTANCE40_LOWERCASExyz_CALCULATE Description Calculat
62. Z_YELLOWNESS_CALCULATE 11 34 21 33 42 57 Yellowness1 Yelowness2 Yellowness3 Three types of yellowness indices will be returned via output variables Yellowness1 Yellowness2 and Yellowness3 for the color given with tristimulus X 11 34 Y 21 33 and Z 42 57 values 36 Anyname CAPITALXYZ YELLOWNESS CALCULATE 41 32 61 57 19 21 Yellowness1925 Yelowness313 YellownessBASF Three types of yellowness indices will be returned via output variables Yellowness1925 Yellowness313 and YellownessBASF for the color given with tristimulus X 41 32 Y 61 57 and Z 19 21 values 37 Subroutineno 17 Subroutine name REFLECTANCE40 WHITENESS CALCULATE Description Calculates one of the following whiteness index for the color given with reflectance values Supported Whiteness index types WI E313 WI CIE D65 2 degree WI CIE D65 10 degree WI Berger D65 2 degree WI Berger D65 10 degree WI Stensby WI Taube WI Ganz Purpose Send reflectance values between 360nm 750nm with 10nm intervals 40 pcs and get whiteness indices General form REFLECTANCE40_WHITENESS_CALCULATE Reflectance40 As Single WhitenessType As Byte Result Whiteness As Single Input parameters Parameter 1 gt Reflectance40 as Single Any array with 40 elements having reflectance values between 360nm 750nm with Onm intervals Example Refs 1 212 345 Reflectance value for 360nm Refs 2 11 395 Reflectance value for 370nm Ref
63. a problem This generally occurs when two or more reflectance curves has a conflict The bigger C the darker color The darker color the smaller reflectance values in the range of 400nm 700nm wavelength In some cases the reflectances values are out of this rule This is due to measuring error or dyeing error of the shades The solution is to re measure the shades and after re dye the shades if the problem persist This function is opposite of REFLECTANCE31 RECIPE CALCULATE Anyname RECIPE Shades SubstrateOrg SubstrateNew Ingredients Result31 Final mixed color reflectance values on SubstrateNew between 360nm 750nm will be output according to the dye shades given in array Shades on SubstrateOrg and amount in array Amounts 99 Subroutine no 39 Subroutine name RGB_CAPITALXYZ_CALCULATE Description Calculates tristimulus X Y and Z values for a color specified with RGB values Purpose Send tristimulus X Y and Z values and get R red G green B blue values General form RGB_CAPITALXYZ_CALCULATE Red As Single Green As Single Blue As Single Result CAPITAL X As Single Result CAPITAL Y As Single Result CAPITAL Z As Single Input parameters Parameter 1 gt Red As Single A value between 0 255 indicating R Red component of the color Parameter 2 gt Yesil As Single A value between 0 255 indicating G Green component of the color Parameter 3 gt Mavi As Single A value between 0 255 indi
64. ab color space of the standard master color Parameter 2 gt Hunter a Std As Single a value HunterLab color space of the standard master color Parameter 3 gt Hunter b Std As Single b value HunterLab color space of the standard master color Parameter 4 gt Hunter L Trial As Single L value HunterLab color space of the trial sample color Parameter 5 gt Hunter a Trial As Single a value HunterLab color space of the trial sample color Parameter 6 gt Hunter b Trial As Single b value HunterLab color space of the trial sample color Output parameters Parameter 1 gt Result Hunter DELTAL As Single Returns HunterLab color space DELTA L Lightness difference value between two colors specified Parameter 2 s Result Hunter DELTAa As Single Returns HunterLab color space DELTA a Greenish Redish difference value between two colors specified Parameter 3 gt Result Hunter DELTAb As Single Returns HunterLab color space DELTA b Yellowish Blueish difference value between two colors specified Parameter 4 gt Result Hunter DELTAE As Single Returns HunterLab color space DELTA E perceived difference value between two colors specified 21 Notes 1 As all output numeric parameters has decimal point be sure that the type of those parameters are defined properly in your source code In VB6 we use single declaration type to do it For example Dim VariableName as Single Or Public Variab
65. absent gt DYE 6 2 shade is absent 86 Later DyeShadesReflectance31 6 3 1 20 DyeShadesReflectance31 6 3 2 20 DyeShadesReflectance31 6 3 3 20 DyeShadesReflectance31 6 3 31 2 0 DyeShadesReflectance3 1 6 3 32 0 Later DyeShadesReflectance3 1 6 4 1 0 DyeShadesReflectance31 6 4 2 0 DyeShadesReflectance31 6 4 3 0 DyeShadesReflectance31 6 4 31 2 0 DyeShadesReflectance31 6 4 32 0 Later DyeShadesReflectance31 6 5 1 0 DyeShadesReflectance31 6 5 2 0 DyeShadesReflectance31 6 5 3 0 DyeShadesReflectance31 6 5 31 0 DyeShadesReflectance3 1 6 5 32 0 Later DyeShadesReflectance3 1 6 6 1 0 DyeShadesReflectance3 1 6 6 2 0 DyeShadesReflectance3 1 6 6 3 0 DyeShadesReflectance31 6 6 31 2 0 DyeShadesReflectance3 1 6 6 32 0 gt DYE 6 3 shade is absent gt DYE 6 3 shade is absent gt DYE 6 3 shade is absent gt DYE 6 3 shade is absent gt DYE 6 3 shade is absent DYE 6 4 shade is absent DYE 6 4 shade is absent DYE 6 4 shade is absent gt DYE 6 4 shade is absent gt DYE 6 4 shade is absent gt DYE 6 5 shade is absent gt DYE 6 5 shade is absent gt DYE 6 5 shade is absent gt DYE 6 5 shade is absent gt DYE 6 5 shade is absent gt DYE 6 6 shade is absent gt DYE 6 6 shade is absent gt DYE 6 6 shade is absent gt DYE 6 6 shade is absent gt DYE 6 6 shade is absent 87 Later DyeShadesReflectance31 6 7 1 20 DyeSha
66. ade is absent 81 Later DyeShadesReflectance31 4 13 1 20 DyeShadesReflectance31 4 13 2 20 DyeShadesReflectance31 4 13 3 20 DyeShadesReflectance31 4 13 31 2 0 DyeShadesReflectance31 4 13 32 0 Later DyeShadesReflectance31 4 14 1 0 DyeShadesReflectance31 4 14 2 20 DyeShadesReflectance31 4 14 3 20 DyeShadesReflectance31 4 14 31 2 0 DyeShadesReflectance31 4 14 32 0 Later DyeShadesReflectance31 4 15 1 20 DyeShadesReflectance31 4 15 2 20 DyeShadesReflectance31 4 15 3 20 DyeShadesReflectance31 4 15 31 2 0 DyeShadesReflectance31 4 15 32 2 0 gt DYE 4 13 shade is absent gt DYE 4 13 shade is absent DYE 4 13 shade is absent gt DYE 4 13 shade is absent gt DYE 4 13 shade is absent gt DYE 4 14 shade is absent gt DYE 4 14 shade is absent gt DYE 4 14 shade is absent gt DYE 4 14 shade is absent gt DYE 4 14 shade is absent gt DYE 4 15 shade is absent gt DYE 4 15 shade is absent gt DYE 4 15 shade is absent gt DYE 4 15 shade is absent gt DYE 4 15 shade is absent DYE 4 shades placement into the array has been done Now let s continue with DYE 5 DyeShadesReflectance31 5 1 1 20 01 DyeShadesReflectance3 1 5 1 2 56 98 DyeShadesReflectance3 1 5 1 3 59 625 gt DYE 5 1 shade concentration gt DYE 5 1 shade 400nm reflectance gt DYE 5 1 shade 410nm reflectance DyeShadesReflectance31 5 1 31 90 035 gt DYE 5 1 shade 690nm reflectance DyeS
67. ameter does not return any value For more information about light sources see table LIGHT SOURCE SELECTION TABLE at the end of this document Parameter 7 gt Result LightSource2 As String Returns the secondary light source which is used to calculate the values in output parameter Result Reflectance40 If the parameter Result DataType is 39 then this parameter does not return any value For more information about light sources see table LIGHT SOURCE SELECTION TABLE at the end of this document Parameter 8 gt Result Observer As String Returns the observer degree which is used to calculate of the values in parameter 6 and 7 If the parameter Result DataType is 39 then this parameter does not return any value 10 10 degree observer 2 2 degree observer Parametre 9 s Result Reflectance40 As Single Return the values of the color in specified memory location These values may be XYZ tristimulus values L a b values HunterLab values or reflectance values according to the parameter 5 Notes This function is valid only for some models which has memory of KonicaMinolta These instruments are CM2300d CM2500c CM2500d ve CM2600d Example Result DDOWNLOAD Form MSComm1 3 4 12 Mode UV Type Name Space Lightl Light2 Observer Values The recorded color values in memory location 12 of the instrument 2600d is called via serial port 3 of MsComm1 object on Form1 121 If the opertaion is succesful
68. anging between first color and second color will be output via variable MetameriIndex In this example 44 12 means L value under first light source of the first color 3 12 means a value under first light source of the first color 7 78 means b value under first light source of the first color 45 01 means L value under first light source of the second color 3 99 means a value under first light source of the second color 8 7 means b value under first light source of the second color 46 17 means L value under second light source of the first color 4 14 means a value under second light source of the first color 6 01 means b value under second light source of the first color 48 03 means L value under second light source of the second color 5 21 means a value under second light source of the second color 7 11 means b value under second light source of the second color Anyname CIELab METAMERISM CALCULATE 40 12 13 12 27 78 42 01 13 99 28 71 46 17 14 14 26 01 48 03 15 21 27 11 MetIndex Metamerism index showing difference changing between first color and second color will be output via variable MetIndex In this example 40 12 means L value under first light source of the first color 13 12 means a value under first light source of the first color 27 78 means b value under first light source of the first color 42 01 means L value under first light source of the second color 13 99 means a value under first light source of the second color 2
69. arameter 1 KS As Single A single K S value Output parameters Parameter 1 gt KS REFLECTANCE CONVERT Unlike the other first 30 subroutines above this one has been designed as a function also This means that output parameter is the function name KS REFLECTANCE CONVERT Notes 1 As all output numeric parameters has decimal point be sure that the type of those parameters are defined properly in your source code In VB6 we use single declaration type to do it For example Dim VariableName as Single Or Public VariableName as Single Examples REF Anyname KS_ REFLECTANCE CONVERT 4 16 Reflectance value will be calculated for the KS 4 16 and result will be output via variable REF Result Anyname RS REFLECTANCE CONVERT 41 65 Reflectance value will be calculated for the KS 41 65 and result will be output via variable Result 95 Subroutine no 36 Subroutine name VERSION Description Returns version number of DLL Purpose To identify you are up to date General form VERSIONO As String Input parameters No input parameter exist Output parameters Parameter 1 gt VERSION Like the other subroutines above number 31 and 32 this one has been designed as a function also This means that output parameter is the function name VERSION Notes Output parameter are in string format so be sure that variable has been defined properly in your code Examples REF Anyname KS_ REFLECTANCE CONVERT 4 16 Reflectance
70. ave different ways to do this We will consider Visual Basic 6 0 for all descriptions rest of this manual If you are using another languages like Deplhi DotNet C C etc please refer its manuals about Referencing DLLs For Visual Basic 6 0 follow the easy 3 steps below Step 1 Adding DLL into your project a Copy DLL into Windows System32 directory b Open Visual Basic 6 0 and select your existing project or create a new empty one c Select Project References from Visual Basic 6 0 menu at the top d Click Browse e Locate ColorCalculationTreasure dll you copied and select it by clicking on it Step 2 Assigning a name to call all subroutines in the DLL Add following two lines in module level of your project Public AnyNamel As ColorCalculateTreasure Public AnyName2 As InstrumentCommandTreasure AnyName is any name you will write according to variable name rules in VB6 For example Public ColorFunctions As ColorCalculateTreasure Public InstrumentFunctions as InstrumentCommandTreasure Step 3 Calling subroutines at anywhere you wish in your project You can use following single line where you want to call a subroutine from DLL Set AnyName New ColorCalculateTreasure p s AnyName in this statement must be same with step 2 For example Set ColorFunctions 2 New ColorCalculateTreasure After this last step when you write AnyName and as soon as press dot you will automatically get a scrollable list in alp
71. bles F1 Wash and F2 Staining Anyname CIELab GRAY SCALE CALCULATE 46 12 29 34 10 56 46 17 29 17 10 55 WashF StainingF Wash fastness and staining grade will be calculated according to two samples given with CIELab values before test gt L 46 12 a 29 34 b 10 56 and after test gt L 45 07 a 29 17 b 10 55 and grades will be returned via variables WashF Wash and StainingF Staining 48 Subroutine no 24 Subroutine name CIELabDELTAE GRAY SCALE CALCULATE Description Calculates Gray Scale rating factors for wash fastness and staining of a color Purpose Send DELTA E CIELab value between samples before and after test and get wash fastness and staining ratings between 1 and 5 General form CIELabDELTAE GRAY SCALE CALCULATE CIELab DE As Single Result A02WashFastness As String Result A03Staining As String Input parameters Parameter 1 gt CIELab DE As Single CIELab DELTA E value between two samples before test as standard and after test as trial Output parameters Parameter 1 s Result A02VVashFastness As String Returns Wash Fastness grade between 1 and 5 Parameter 2 gt Result A03Staining As String Returns Staining grade between 1 and 5 Notes 1 As all output numeric parameters has decimal point be sure that the type of those parameters are defined properly in your source code In VB6 we use single declaration type to do it For example Dim VariableName as Single Or P
72. brary oed b ai Help LJLILIDIEIEIKIISIKIKII Color Calculation Function Treasure by Artoksi un artoksi com Location C WINDOWS system32 ColorCalculationFunctions dll Language Standard Checkpoint2 Check the code you wrote 5 6 7 At module level Public AnyName As ColorCalculateTreasure At anywhere you wish to call a subroutine from the DLL Set AnyName New ColorCalculateTreasure Anyname Be sure that you are using same variable name for Anyname in everywhere in the your source code For example At module level Public ColorFunctions As ColorCalculateTreasure At anywhere you wish to call a subroutine Set ColorFunctions New ColorCalculateTreasure ColorFunctions How do I know which values parameters should be transferred to each subroutines as input Or How do I know the format of each subroutines to use them properly In VB6 when you select a function it automatically displays which parameters should be input and types of it See figure 1 All the parameters in each function have been named carefully according to maximum understanding principals for users We believe that you will not need to this manual in fact when you start to work with the DLL ColorCalculationTreasures Everything you need is going to be on the screen automatically as soon as you press dot sign following your assigned variable name while writing your code especially in Visual Basic If this
73. calibration then you may need to perform black calibration first If you don t know if the instrument requires black calibration inpect the accesories given with the instruments If there is no black calibration parts then the instrument does not requires black calibration The sequence of calibration first white and black or first black and white is fatal and may be different on each instrument Refer to the instrument s manual to understand which one is first If the instrument has no black calibration accesories this does not mean black calibration is uncessary It may be optional It may be optional In such a case we recomend you to perform black calibration for better measurement results ResultzAnyname2 CALIBRATE WHITE Form1 MSComm1 2 3 3001714 KonicaMinolta 2500d will be calibrated with white plate with serial number 3001714 via MScomm object MsComm3 in the form Form1 using serial channel 2 111 If the command is executed succesfully then variable Result will return OKEY If it is not executed successfuly for a reason then it will return FAIL following by an explanation Example FAIL 11 Black amp white calibration is not ok StatuscAnyname2 CALIBRATE WHITE Calibration MSComm3 2 12 XA7142 GretagMacbeth 700A will be calibrated with white plate with serial number XA7142 via MScomm object MsComm3 in the form Calibration using serial channel 2 If the command is executed succesfully
74. cates measurements area 0 gt Large area view LAV gt Medium area view MAV 2 Small area view SAV 3 Very small area view VSAV 7 character Seperator id 8 1 character Indicates lens position 0 gt Large area view LAV gt Medium area view MAV 2 Small area view SAV 3 gt Very small area view VSAV character Seperator ue 10 1 character Indicates UV filter position 0 included 90100 1 excluded 400nm 2 excluded 400nm low profile 3 excluded 420nm 4 excluded 420nm low profile 5 adjusted 400nm normal 6 adjusted 400nm d k 7 adjusted 420nm normal 8 adjusted 420nm low profile A excluded 100 11 character Seperator nd 12 character Indicates specular component 0 SCI position 1 SCE 13 1 character Seperator Hutt 14 character Indicates measurement style 0 Reflection 1 Transmission 15 character Seperator nd 16 9 character Indicates instrument serial no XXXXXXXXX 25 character Seperator d 26 9 character Indicates white calibration plate XXXXXXXXX serial no 35 1 character Seperator es 36 1 character Indicates white calibration status 0 white calibration is missing 1 white calibration is ok 37 1 character Seperator MO 38 1 character Indicates black calibration status 0 black calibration is missing 1 black calibration is ok Notes Some digits in this string may return as
75. cating B Blue component of the color Output parameters Parameter 1 gt Result CAPITAL X As Single Calculated tristimulus X value of the color Parameter 2 gt Result CAPITAL Y As Single Calculated tristimulus Y value of the color Parameter 3 gt Result CAPITAL Z As Single Calculated tristimulus X value of the color Notes 1 As all output numeric parameters has decimal point be sure that the type of those parameters are defined properly in your source code In VB6 we use single declaration type to do it For example Dim VariableName as Single Or Public VariableName as Single Examples HerHangiBirlsin RGB_CAPITALXYZ_CALCULATE 124 111 98 TX TY TZ Calculates tristimulus X Y and Z values of the color specified with R red 124 G green 111 and B blue 98 and the results will be in the variables TX TY and TZ 100 Subroutine no 40 Subroutine name CAPITALXYZ CIELab CALCULATE Description Calculates L a and b values for CIELab color space from the values tristimulus X Y and Z Purpose Send L a and b values of CIELab color space and gets tristimulus X Y and Z values General form CAPITALXYZ CIELab CALCULATE CAPITAL X As Single CAPITAL Y As Single CAPITAL Z As Single LightSource As String Observer As Byte Result CIE L As Single Result CIE a As Single Result CIE b As Single Input parameters Parameter 1 gt CAPITAL X As Single Tristimulus X value of the color Parameter 2 gt C
76. color space of the trail sample color Minus values represent blue zone Plus values represent yellow zone Output parameters Parameter 1 gt Result CIELab DELTAL As Single Returns CIELab color space DELTA L Lightness difference value between two colors specified Parameter 2 gt Result CIELab DELTAa As Single Returns CIELab color space DELTA a Greenish Redish difference value between two colors specified 17 Parameter 3 gt Result CIELab DELTAb As Single Returns CIELab color space DELTA b Yellowish Blueish difference value between two colors specified Parameter 4 gt Result CIELab DELTAE As Single Returns CIELab color space DELTA E perceived difference value between two colors specified Notes 1 As all output numeric parameters has decimal point be sure that the type of those parameters are defined properly in your source code In VB6 we use single declaration type to do it For example Dim VariableName as Single Or Public VariableName as Single 2 Output parameters Result CIELab DELTAL CIELab DELTAa and CIELab DELTAb may return plus or minus value so be sure that variable has been defined properly in your code Examples Anyname CIELab_DELTA_CALCULATE 11 12 3 06 2 17 12 09 3 21 1 16 DiffL Diffa Diffb DiffE The differences between standard color L 11 12 a 3 06 b 2 17 and trial color L 12 09 a 3 21 bz1 16 will be calculated and differences between these two colors will
77. ctances 400 700nm represent reflectance values calculated by DLL subroutine Last line represents DELTA E differences in CIELAB color space D65 10 between targeted and calculated reflectance values 91 Parameter 7 gt Screen as Boolean Indicates either an information screen which shows some details will be displayed or not This information screen includes some details like number of recipe alternatives in process best recipe Delta E found number of recipe in que etc which helps user to view the process in real time If this parameter set to True the screen is displayed If it is set to False then the screen will not be displayed and the calculation is performed in background The screen is vanished automatically when the calculation finished A sample information screen is as follows Phase Calculation Scanned Finished Total 0 1320 Best recipe until now DE 3 27 Except arhive 0 00003 gt 0 00000 gt 0 00000 Parametre 8 gt InformationY as Integer Indicates Y coordinate of the information screen if it is set to true in parameter 6 Parametre 9 gt InformationX as Integer Indicates X coordinate of the information screen if it is set to true in parameter 6 Output parameters Parameter 1 gt Result_NumberOfAlternatives As Integer This parameter returns how many alternatives has been calculated and so how many text file was created which stores the recipes details Notes
78. desReflectance31 2 15 2 20 DyeShadesReflectance31 2 15 3 20 DyeShadesReflectance31 2 15 31 2 0 DyeShadesReflectance31 2 15 32 2 0 DYE 2 15 shade is absent DYE 2 15 shade is absent gt DYE 2 15 shade is absent gt DYE 2 15 shade is absent gt DYE 2 15 shade is absent DYE 2 shades placement into the array has been done Now let s continue with DYE 3 DyeShadesReflectance31 3 1 1 20 05 DyeShadesReflectance31 3 1 2 239 68 DyeShadesReflectance31 3 1 3 237 0 DyeShadesReflectance31 3 1 31 2 74 925 DyeShadesReflectance31 3 1 32 2 75 16 Later DyeShadesReflectance31 3 2 1 20 075 DyeShadesReflectance31 3 2 2 236 75 DyeShadesReflectance31 3 2 3 233 345 DyeShadesReflectance31 3 2 31 2 72 215 DyeShadesReflectance3 1 3 2 32 72 455 Later DyeShadesReflectance31 3 3 1 20 15 DyeShadesReflectance31 3 3 2 227 47 DyeShadesReflectance31 3 3 3 223 68 DyeShadesReflectance31 3 3 31 2 74 33 DyeShadesReflectance31 3 3 32 2 74 70 gt DYE 3 1 shade concentration DYE 3 1 shade 400nm reflectance gt DYE 3 1 shade 410nm reflectance gt DYE 3 1 shade 690nm reflectance gt DYE 3 1 shade 700nm reflectance gt DYE 3 2 shade concentration gt DYE 3 2 shade 400nm reflectance gt DYE 3 2 shade 410nm reflectance gt DYE 3 2 shade 690nm reflectance gt DYE 3 2 shade 700nm reflectance gt DYE 3 3 shade concentration gt DYE 3 3 shade 400nm reflectance gt DYE 3 3 shade 410n
79. desReflectance31 6 7 2 0 DyeShadesReflectance31 6 7 3 0 DyeShadesReflectance31 6 7 31 2 0 DyeShadesReflectance31 6 7 32 0 Later DyeShadesReflectance3 1 6 8 1 0 DyeShadesReflectance31 6 8 2 20 DyeShadesReflectance31 6 8 3 20 DyeShadesReflectance31 6 8 31 2 0 DyeShadesReflectance3 1 6 8 32 0 Later DyeShadesReflectance3 1 6 9 1 0 DyeShadesReflectance3 1 6 9 2 0 DyeShadesReflectance3 1 6 9 3 0 DyeShadesReflectance31 6 9 31 2 0 DyeShadesReflectance31 6 9 32 0 Later DyeShadesReflectance31 6 10 1 20 DyeShadesReflectance31 6 10 2 20 DyeShadesReflectance31 6 10 3 20 DyeShadesReflectance31 6 10 31 2 0 DyeShadesReflectance31 6 10 32 0 gt DYE 6 7 shade is absent gt DYE 6 7 shade is absent gt DYE 6 7 shade is absent gt DYE 6 7 shade is absent gt DYE 6 7 shade is absent gt DYE 6 8 shade is absent gt DYE 6 8 shade is absent gt DYE 6 8 shade is absent gt DYE 6 8 shade is absent gt DYE 6 8 shade is absent gt DYE 6 9 shade is absent gt DYE 6 9 shade is absent gt DYE 6 9 shade is absent gt DYE 6 9 shade is absent gt DYE 6 9 shade is absent gt DYE 6 10 shade is absent gt DYE 6 10 shade is absent gt DYE 6 10 shade is absent gt DYE 6 10 shade is absent gt DYE 6 10 shade is absent 88 Later DyeShadesReflectance31 6 11 1 20 DyeShadesReflectance31 6 11 2 20 DyeShadesReflectance31 6 11 3 20 DyeShadesReflectance31
80. e Tristimulus Y value of the color Parameter 3 gt CAPITAL Z As Single Tristimulus Z value of the color Output parameters Parameter 1 gt Result Brightness Z As Single Returns Z brightness value of the color given with X Y and Z tristimulus value Notes 1 As all output numeric parameters has decimal point be sure that the type of those parameters are defined properly in your source code In VB6 we use single declaration type to do it For example Dim VariableName as Single or Public VariableName as Single Examples Anyname CAPITALXYZ BRIGHTNESS CALCULATE 41 87 10 21 33 56 BrZ Z brightness value for the color given with tristimulus values X 41 87 Y 10 21 and Z 33 56 will be output via variable Brz Anyname CAPITALXYZ BRIGHTNESS CALCULATE 53 87 23 21 29 56 Zbrg Z brightness value for the color given with tristimulus values X 53 87 Y 23 21 and Z 29 56 will be output via variable Zbrg 58 Subroutine no 30 Subroutine name REFLECTANCE40_METAMERISM_CALCULATE Description Calculates metamerism color difference change between two different light source Purpose Send reflectance values and two lightsources and get how the color difference Is changing under different illuminats metamerism General form REFLECTANCE40 METAMERISM CALCULATE Reflectance40 Std As Single Reflectance40 Trial As Single LightSourcel As String LightSource2 As String Observer As Byte Result Metamerism As Single
81. e as Single 101 2 Reflectance values are values This means that all values are between 0 to 100 3 Output parameters Result CIE a and Result CIE b may return plus or minus value so be sure that variable has been defined properly in your code Examples HerHangiBirlsiml CAPITALXYZ CIELab CALCULATE 22 3 16 7 31 34 D65 10 CIE L CIE a CIE b Calculates L a and b values for CIELab color space for the color specified with tristimulus values as X 22 3 Y 16 7 31 34 The results will be presented via variables CIE L CIE a CIE b 102 SECTION 2 Color Measurement Instrument Control Commands Description This chapter describes each subroutine in DLL nce beni oku 1 All functions have been named to help to user to understand purpose of command at first view Example 1 CALIBRATE WHITE means This function is used to make the instrument white calibration Or MEASURE means This function tells to instrument to take a measurement 1 This DLL supports following instruments 3 KoninaMinolta series CM2300d GretagMacbeth series CE2020 CE2020 CE2180 CE2180UV CE3000 CE3100 CE7000 CE7000A XTH PenColorArt series PenColorArt USB For other brands and model please write to artoksi artoksi com Please keep in mind that each instrument has different features So paramaters SCI E UV fitler Transmission etc in functions below may be meaningless for he instrument type specified In such
82. e is absent 76 Later DyeShadesReflectance31 3 8 1 20 DyeShadesReflectance31 3 8 2 20 DyeShadesReflectance31 3 8 3 20 DyeShadesReflectance31 3 8 31 2 0 DyeShadesReflectance3 1 3 8 32 0 Later DyeShadesReflectance3 1 3 9 1 0 DyeShadesReflectance3 1 3 9 2 0 DyeShadesReflectance3 1 3 9 3 0 DyeShadesReflectance31 3 9 31 2 0 DyeShadesReflectance3 1 3 9 32 0 Later DyeShadesReflectance31 3 10 1 20 DyeShadesReflectance31 3 10 2 20 DyeShadesReflectance31 3 10 3 20 DyeShadesReflectance31 3 10 31 2 0 DyeShadesReflectance31 3 10 32 0 Later DyeShadesReflectance31 3 11 1 20 DyeShadesReflectance31 3 11 2 20 DyeShadesReflectance31 3 11 3 20 DyeShadesReflectance31 3 11 31 2 0 DyeShadesReflectance31 3 11 32 2 0 gt DYE 3 8 shade is absent DYE 3 8 shade is absent gt DYE 3 8 shade is absent gt DYE 3 8 shade is absent gt DYE 3 8 shade is absent gt DYE 3 9 shade is absent gt DYE 3 9 shade is absent gt DYE 3 9 shade is absent gt DYE 3 9 shade is absent gt DYE 3 9 shade is absent gt DYE 3 10 shade is absent gt DYE 3 10 shade is absent gt DYE 3 10 shade is absent DYE 3 10 shade is absent gt DYE 3 10 shade is absent gt DYE 3 11 shade is absent gt DYE 3 11 shade is absent gt DYE 3 11 shade is absent gt DYE 3 11 shade is absent gt DYE 3 11 shade is absent TI Later DyeShadesReflectance31 3 12 1 20 DyeShadesReflectance3
83. e that the type of those parameters are defined properly in your source code In VB6 we use single declaration type to do it For example Dim VariableName as Single or Public VariableName as Single 2 Reflectance values are values This means that all values are between 0 to 100 Examples Anyname REFLECTANCE40_OPACITY_CALCULATE ColorOverBlack ColorOverWhite 3 D65 2 Opacity Opacity according to tristimulus Y value for D65 and 2 degree of the color specified in arrays ColorOverBlack and ColorOverWhite will be output via variable opacity Anyname REFLECTANCE40_OPACITY_CALCULATE SampleOB SampleOW 2 D65 2 result Opacity according to tristimulus X value for D65 and 2 degree of the color specified in arrays SampleOB and SampleOW will be output via variable result 51 Subroutine no 26 Subroutine name CAPITALXYZ OPACITY CALCULATE Description Calculates 96opacity of a sample Purpose Send tristimulus X Y and Z values of sample overblack and overwhite and get Goopacity value General form CAPITALXYZ OPACITY CALCULATE CAPITAL X OverWhite As Single CAPITAL Y OverWhite As Single CAPITAL Z OverWhite As Single CAPITAL X OverBlack As Single CAPITAL Y OverBlack As Single CAPITAL Z OverBlack As Single OpacityType As Byte Result Opacity As Single Input parameters Parameter 1 gt CAPITAL X OverWhite As Single Tristimulus X value of the color over white Parameter 2 g
84. eclaration type to do it For example Dim VariableName as Single Or Public VariableName as Single 2 TINT values are calculated under D65 and 10 degree observer Please be sure that X Y and Z trisitimulus values supplied corresponds this principle Examples Anyname CAPITALXYZ_TINT_CALCULATE 41 12 18 91 72 17 Result_T1 Result_T2 TINT values for the color given with tristimulus values X 41 12 Y 18 91 and Z 72 17 will be output via variable Result_T1 Ganz Griesser and Result_T2 E313 Anyname CAPITALXYZ_TINT_CALCULATE 12 21 44 44 19 89 Result_TINT1 Result_TINT2 TINT values for the color given with tristimulus values X 12 21 Y 44 44 and Z 19 89 will be output via variable Result_TINT1 Ganz Griesser and Result_TINT2 E313 43 Subroutine no 21 Subroutine name LOWERCASEXYZ TINT CALCULATE Description Calculates both TINT value Ganz Griesser and E313 for the color given with chromaticity coordinates lowercase x y and z values Purpose Send chromaticity coordinate values lowercase x y z and get TINT values General form LOWERCASEXYZ TINT CALCULATE Lowercase x As Single Lowercase y As Single Lowercase 7 As Single Result TintGG As Single Result TintE313 As Single Input parameters Parameter 1 gt Lowercase x As Single Cromaticity x value of the color see NOTES Term 2 of this subroutine Parameter 2 gt Lowercase y As Single Cromaticity y value of the color see NOTES Term 2 of this
85. en is displayed 93 Subroutine no 34 Subroutine name REFLECTANCE_KS_CONVERT Description Calculates K S absorbtion value from reflectance at a certain wavelength Purpose Send a reflectance value and get K S value General form REFLECTANCE_KS_CONVERT Reflectance As Single As Single Input parameters Parameter 1 s Reflectance As Single A single reflectance value at a certain wavelength Output parameters Parameter 1 gt REFLECTANCE KS CONVERT Unlike the other subroutines above this one has been designed as a function This means that output parameter is the function name REFLECTANCE KS CONVERT Notes 1 As all output numeric parameters has decimal point be sure that the type of those parameters are defined properly in your source code In VB6 we use single declaration type to do it For example Dim VariableName as Single Or Public VariableName as Single Examples KS Anyname REFLECTANCE_KS_CONVERT 65 12 KS value will be calculated for the reflectance 65 12 and result will be output via variable KS Result Anyname REFLECTANCE_KS_CONVERT 15 32 KS value will be calculated for the reflectance 15 32 and result will be output via variable result 94 Subroutine no 35 Subroutine name KS_REFLECTANCE_CONVERT Description Calculates reflectance value from a K S value Purpose Send a K S value and get reflectance value General form KS REFLECTANCE CONVERT KS As Single As Single Input parameters P
86. er value Description 1 KonicaMinolta CM2300d 2 KonicaMinolta CM2500c 3 KonicaMinolta CM2500d 4 KonicaMinolta CM2600d 5 KonicaMinolta CM3220d 6 KonicaMinolta CM3600d 7 KonicaMinolta CMI3700 GretagMacbeth CE2020 9 GretagMacbeth CE2020 10 GretagMacbeth CE2180 11 GretagMacbeth CE2180UV 12 GretagMacbeth CE3000 13 GretagMacbeth CE3100 14 GretagMacbeth CE7000 15 GretagMacbeth CE7000A 16 GretagMacbeth XTH 17 PenColorArt USB M hendislik Sanatlar1 Merkezi www artoksi com 124
87. es lowercase x y and z chromaticity values from reflectance values of a color Purpose Send reflectance values between 360nm 750nm with 10nm interval 40 pcs and get X y z tristimulus values General form REFLECTANCE40_LOWERCASExyz_CALCULATE Reflectance40 As Single LightSource As String Observer As Byte Result_Lowercase_x As Single Result_Lowercase_y As Single Result_Lowercase_z As Single Input parameters Parameter 1 gt Reflectance40 as Single Any array with 40 elements having reflectance values between 360nm 750nm with 10nm intervals Example Refs 1 12 345 Reflectance value for 360nm Refs 2 11 395 Reflectance value for 370nm Refs 39 32 123 Reflectance value for 740nm Refs 40 36 523 Reflectance value for 750nm Parameter 2 gt LightSource As String One of the options from LIGHT SOURCES SELECTION REFERENCE TABLE At the end of this document to tell the subroutine which light source will be used simulated to calculate x y z chromaticity values Parameter 3 gt Observer as Byte One of the options below to tell the subroutine which observer for the specified light source will be used to calculate X Y Z tristimulus values 2 Weighing factors for 2 degree observer will be used 10 gt Weighing factors for 10 degree observer will be used Output parameters Parameter 1 gt Result Lowercase x Returns x chromaticity value Parameter 2 gt Result Lowercase y Returns y chromatic
88. ewly added MsComm object Figure 5 Sample ct was added corecctly 104 b There is one more step after this to use MScomm object Just simply drag amp drop this object into any form you wish to communicate with the instrument 2 General process on instrument management are as follows a b c d e Check instrument status UV filter lens SCI SCE settings transmission reflectance mode etc by using INSTRUMENT STATUS command If the settings is not as you need set the instrument as you want by using SET INSTRUMENT command Re check instrument status UV filter lens SCI SCE settings transmission reflectance mode etc by using INSTRUMENT STATUS command Calibrate the instrument by using CALIBRATE WHITE and or CALIBRATE BLACK commands Measure the color by using MEASURE command 105 Subroutine no 21 Subroutine name SET INSTRUMENT Description Lets you to change the instrument s settings lens UV filter SCI SCE etc for a desired measurement type Purpose Set instrument settings for a sample to be measured General form SET INSTRUMENT ComObject As Object ComPortNo As Byte Instrument As Byte Target RT As String Target SCIE As String Target View As String Target UV As String As String Input parameters Parameter 1 gt ComObject As Object Obejct full name of serial communication object Name of the MsComm object in the Form For example Assume that a form namely Form1
89. flectance 79 Later DyeShadesReflectance31 4 5 1 2 0 3 DyeShadesReflectance31 4 5 2 2 37 24 DyeShadesReflectance31 4 5 3 2 31 345 DyeShadesReflectance31 4 5 31 2 72 5 DyeShadesReflectance31 4 5 32 72 68 Later DyeShadesReflectance31 4 6 1 20 4 DyeShadesReflectance31 4 6 2 233 31 DyeShadesReflectance31 4 6 3 227 015 DyeShadesReflectance31 4 6 31 2 71 95 DyeShadesReflectance31 4 6 32 72 15 Later DyeShadesReflectance31 4 7 1 20 5 DyeShadesReflectance31 4 7 2 232 15 DyeShadesReflectance3 1 4 7 3 25 395 DyeShadesReflectance3 1 4 7 31 73 345 DyeShadesReflectance3 1 4 7 32 73 565 Later DyeShadesReflectance31 4 8 1 20 6 DyeShadesReflectance31 4 8 2 226 977 DyeShadesReflectance31 4 8 3 220 28 DyeShadesReflectance31 4 8 31 2 72 36 DyeShadesReflectance31 4 8 32 2 72 635 gt DYE 4 5 shade concentration gt DYE 4 5 shade concentration gt DYE 4 5 shade concentration gt DYE 4 5 shade concentration gt DYE 4 5 shade concentration gt DYE 4 6 shade concentration gt DYE 4 6 shade concentration gt DYE 4 6 shade concentration gt DYE 4 6 shade concentration gt DYE 4 6 shade concentration gt DYE 4 7 shade concentration gt DYE 4 7 shade concentration gt DYE 4 7 shade concentration DYE 4 7 shade concentration gt DYE 4 7 shade concentration gt DYE 4 8 shade concentration gt DYE 4 8 shade concentration gt DYE 4 8 shade concentration gt DYE
90. four different strings Redish Reder Less red Greenish Greener Less Green Parameter 3 gt Result Comment3 As String Returns one of four different strings Blueish Blueer Less blue Yellowish Yellower Less Yellow Notes All assessments result should be considered as second color to first color Examples Anyname CIELab DELTA ASSESSMENTS 1 2 12 3 31 6 23 4 2 18 25 9 R1 R2 R3 The reason of difference of two colors specifed as L1 21 2 al 12 3 b1 31 6 and L2 23 4 a2 2 18 b2 25 9 will be explained via three out parameters R1 R2 R3 Anyname CIELab DELTA ASSESSMENTS 2 2 2 3 31 6 3 4 2 18 25 9 Reasonl Reason2 Reason3 The reason of difference of two colors specifed as L1 2 2 al 2 3 b1 31 6 and L2 3 4 a2 2 18 b2 25 9 will be explained via three out parameters Reasonl Reason2 Reason3 97 Subroutine no Subroutine name Description Purpose General form Input parameters 98 RECIPE REFLECTANCEA40 CALCULATE Returns final color for a given recipe Send amount of dyes in a recipe and get what color will be output RECIPE REFLEKTANCEA40 CALCULATE DyeShadesReflectance31 As Single ShadesSubstrateReflectance31 As Single TargetSubstrateReflectance31 As Single Amounts As Single Result Reflectance40 As Single Result Error as String Parameter 1 gt DyeShadesReflectance31 As Single Three dimensional array with boundaries 6
91. from LIGHT SOURCES SELECTION REFERENCE TABLE at the end of this document to tell the subroutine which light source will be used simulated to calculate X Y Z tristimulus values Parameter 3 gt Observer as Byte One of the options below to tell the subroutine which observer for the specified light source will be used to calculate X Y Z tristimulus values 2 Weighing factors for 2 degree observer will be used 10 gt Weighing factors for 10 degree observer will be used Output parameters Parameter 1 gt Result CAPITAL X As Single Returns X tristimulus value Parameter 2 gt Result CAPITAL Y As Single Returns Y tristimulus value Parameter 3 gt Result CAPITAL Z As Single Returns Y tristimulus value Notes 1 As all output numeric parameters has decimal point be sure that the type of those parameters are defined properly in your source code In VB6 we use single declaration type to do it For example Dim VariableName as Single Or Public VariableName as Single 2 Reflectance values are values This means that all values are between 0 to 100 Examples Anyname REFLACTANCEA0 CAPITALXYZ CALCULATE Array400 D65 10 ResultX ResultY ResultZ X Y Z tristimulus values under illuminant Daylight 6500K and 10 degree observer of the color in Array40 will be returned via variables ResultX Result Y and ResultZ consecutively Anyname REFLACTANCE40 CAPITALXYZ CALCULATE RefArray400 CWF 2 TristX TristY
92. gree observer will be used Output parameters Parameter 1 gt Result CAPITAL X Returns X tristimulus value Parameter 2 Result CAPITAL Y Returns Y tristimulus value Parameter 3 gt Result CAPITAL Z Returns Z tristimulus value Notes As all output numeric parameters has decimal point be sure that the type of those parameters are defined properly in your source code In VB6 we use single declaration type to do it For example Dim VariableName as Single Or Public VariableName as Single 10 Examples Anyname CIELab CAPITALXYZ CALCULATE 25 2 14 65 3 77 D65 10 TX TY TZ X Y and Z tristimulus values for the color specified with L 25 2 a 14 65 and b 3 77 under D65 light source and 10 degree observer will be returned via variables TX TY and TZ consecutively Anyname CIELab CAPITALXYZ CALCULATE 61 17 75 09 17 55 CWF 2 Rslt X Rslt Y Rslt 7 X Y and Z tristimulus values for the color specified with L 61 17 a 75 09 and b 17 55 under CWF Coolwhite light source and 2 degree observer will be returned via variables Rsit X Rslt Y and Rslt Z consecutively 11 Subroutine no 3 Subroutine name CAPITALXYZ_LOWERCASExyz_CALCULATE Description Calculates x y and z chromaticity values from X Y Z tristimulus values of a color Purpose Send X Y Z tristimulus values and get x y z chromaticity values General form CAPITALXYZ_LOWERCASExyz_CALCULATE CAPITAL_X As Single CAPITAL_Y As Single CAPITAL_
93. habetic order similar to Figure 1 showing all subroutines in DLL Set ColorFunctions New ColorCalculateTreasure ColorFunctions End Sub CAPITALKYZ_LOWERCASExyz_CALCULATE CAPITALKYZ_OPACITY_CALCULATE CAP ITALXYZ TI NT CALC ULATE APITALXYZ WHITENESS CALCULATE 7 8 CIELab DELTA CALCULATE S CEL LE c Figure 1 Sample screenshot You are now ready to create professional color matching softwares according to your imagination border to fit your individual requirements or commercial purposes Troubleshooting If you can not get the function list like above Figure 1 as soon as pressing dot after the name you assigned please check followings Checkpoint1 Check references again from Project References menu in VB6 Color Calculation Function Treasure by Artoksi www artoksi com should be marked selected as follows References RenkHesaplari vbp xi a 8 Available References Visual Basic For Applications 2 Cancel Visual Basic runtime objects and procedures Visual Basic objects and procedures OLE Automation Browse Color Calculation Function Treasure by Artoksi www IAS Helper COM Component 1 0 Type Library IAS RADIUS Protocol 1 0 Type Library Acrobat Access 3 0 Type Library Priority AcroIEHelper 1 0 Type Library Active DS Type Library el Active Setup Control Library ActiveMovie control type library ActiveX DLL to perform Migration of MS Repository V1 dobe Acrobat 7 0 Browser Control Type Li
94. hadesReflectance31 5 1 32 294 02 gt DYE 5 1 shade 700nm reflectance 82 Later DyeShadesReflectance31 5 2 1 20 05 DyeShadesReflectance31 5 2 2 251 47 DyeShadesReflectance31 5 2 3 53 62 DyeShadesReflectance31 5 2 31 2 83 785 DyeShadesReflectance31 5 2 32 99 195 Later DyeShadesReflectance31 5 3 1 20 1 DyeShadesReflectance31 5 3 2 248 06 DyeShadesReflectance31 5 3 3 249 90 DyeShadesReflectance31 5 3 31 2 70 625 DyeShadesReflectance3 1 5 3 32 90 20 Later DyeShadesReflectance31 5 4 1 20 15 DyeShadesReflectance31 5 4 2 243 635 DyeShadesReflectance31 5 4 3 245 30 DyeShadesReflectance31 5 4 31 59 31 DyeShadesReflectance31 5 4 32 79 97 Later DyeShadesReflectance31 5 5 1 2 0 3 DyeShadesReflectance31 5 5 2 2 38 2 DyeShadesReflectance31 5 5 3 2 39 51 DyeShadesReflectance31 5 5 31 2 39 73 DyeShadesReflectance31 5 5 32 2 59 0 gt DYE 5 2 shade concentration gt DYE 5 2 shade 400nm reflectance gt DYE 5 2 shade 410nm reflectance gt DYE 5 2 shade 690nm reflectance gt DYE 5 2 shade 700nm reflectance gt DYE 5 3 shade concentration DYE 5 3 shade 400nm reflectance DYE 5 3 shade 410nm reflectance gt DYE 5 3 shade 690nm reflectance DYE 5 3 shade 700nm reflectance gt DYE 5 4 shade concentration gt DYE 5 4 shade 400nm reflectance gt DYE 5 4 shade 410nm reflectance gt DYE 5 4 shade 690nm reflectance gt DYE 5 4 shade 700nm reflectance g
95. ining Parameter 4 gt CIE L Trial As Single L value in CIELab color space for the sample after test process washing test for wash fastness or crockmeter test for staining Parameter 5 gt CIE a Trial As Single a value in CIBLab color space for the sample after test process washing test for wash fastness or crockmeter test for staining Parameter 6 gt CIE b Trial As Single b value in CIELab color space for the sample after test process washing test for wash fastness or crockmeter test for staining Output parameters Parameter 1 gt Result A02VVashFastness As String Returns Wash Fastness grade between 1 and 5 Parameter 2 gt Result A03Staining As String Returns Staining grade between 1 and 5 Notes 1 As all output numeric parameters has decimal point be sure that the type of those parameters are defined properly in your source code In VB6 we use single declaration type to do it For example Dim VariableName as Single or Public VariableName as Single 47 2 Output parameters are in string format so be sure that variable has been defined properly in your code Examples Anyname CIELab GRAY SCALE CALCULATE 56 12 21 34 14 56 41 17 20 17 12 55 F1 F2 Wash fastness and staining grade will be calculated according to two samples given with CIELab values before test gt L 56 12 a 12 34 b 14 56 and after test gt L 41 17 a 20 17 b 12 55 and grades will be returned via varia
96. is absent gt DYE 1 11 shade is absent gt DYE 1 12 shade is absent gt DYE 1 12 shade is absent gt DYE 1 12 shade is absent gt DYE 1 12 shade is absent gt DYE 1 12 shade is absent gt DYE 1 13 shade is absent gt DYE 1 13 shade is absent gt DYE 1 13 shade is absent gt DYE 1 13 shade is absent gt DYE 1 13 shade is absent gt DYE 1 14 shade is absent gt DYE 1 14 shade is absent gt DYE 1 14 shade is absent gt DYE 1 14 shade is absent gt DYE 1 14 shade is absent gt DYE 1 15 shade is absent gt DYE 1 15 shade is absent gt DYE 1 15 shade is absent gt DYE 1 15 shade is absent gt DYE 1 15 shade is absent 71 DYE 1 shades placement into the array has been done Now let s continue with DYE 2 DyeShadesReflectance31 2 1 1 20 0075 gt DYE 2 1 shade concentration DyeShadesReflectance31 2 1 2 248 935 gt DYE 2 1 shade 400nm reflectance DyeShadesReflectance31 2 1 3 47 425 gt DYE 2 1 shade 410nm reflectance e e DyeShadesReflectance31 2 1 31 75 255 gt DYE 2 1 shade 690nm reflectance DyeShadesReflectance3 1 2 1 32 75 345 gt DYE 2 1 shade 700nm reflectance Later DyeShadesReflectance31 2 2 1 20 01 gt DYE 2 2 shade concentration DyeShadesReflectance31 2 2 2 226 76 gt DYE 2 2 shade 400nm reflectance DyeShadesReflectance31 2 2 3 223 17 gt DYE 2 2 shade 410nm reflectance e e DyeShadesReflectance31 2 2 31 75 41 g
97. is not enough clear then you can apply Function Description Section of this manual This section has more information about How to use them of each function of subroutines in the DLL Is there a sample software to let me understand better how all this above issues work in reality Yes the package you have now has also a fully functional software written in Visual Basic language This software is given to you with open source code You can load it via your Visual Basic 6 and run This helps you to understand better everything What do you ship when I buy this When you buy ColorCalculationTreasure DLL you will have followings 1 ColorCalculationTreasure DLL file 2 ColorCalculationTreasure DLL user manual downloadable from www artoksi com 3 ColorCalculation demo software setup version downloadable from www artoksi com 4 ColorCalculation demo software open source code downloadable from www artoksi com 5 A dongle for calling DLL USB should be shipped with a courier tem no 2 at above list represents this document 7 Why do you use dongle instead of software lock Using dongle hardkey has mutual benefits for you and us Our benefit is to have more reliable way to protect our efforts against pricy and your benefit is to protect your softwares also automatically when you use this DLL in your code You don t need to spend extra money and efforts to protect your product Already done Because each time you call DLL from you
98. ith X Y and Z tristimulus values Purpose Send X Y and Z trisitimulus values under illuminant C and observer 2 degree and get three type yellowness indices ASTMD1925 ASTME313 and Result BASFGB General form CAPITALXYZ YELLOWNESS CALCULATE CAPITAL X C2 As Single CAPITAL Y C2 As Single CAPITAL Z C2 As Single Result ASTMD1925 As Single Result ASTME313 As Single Result BASFGB As Single Input parameters Parameter 1 gt CAPITAL X C2 As Single Tristimulus X value under illuminant C and 2 degree observer Parameter 2 gt CAPITAL Y C2 As Single Tristimulus Y value under illuminant C and 2 degree observer Parameter 3 gt CAPITAL Z C2 As Single Tristimulus Z value under illuminant C and 2 degree observer Output parameters Parameter 1 gt Result ASTMD1925 As Single Returns ASTMD1925 yellowness indice for the color given with tristimulus X Y and Z values Parameter 2 gt Result ASTME313 As Single Returns ASTME313 yellowness indice for the color given with with tristimulus X Y and Z values Parameter 3 gt Result BASFGB As Single Returns BASFGB yellowness indice for the color given with tristimulus X Y and Z values Notes 1 As all output numeric parameters has decimal point be sure that the type of those parameters are defined properly in your source code In VB6 we use single declaration type to do it For example Dim VariableName as Single or Public VariableName as Single Examples Anyname CAPITALXY
99. ity value Parameter 3 gt Result Lowercase z Returns z chromaticity value Notes 1 As all output numeric parameters has decimal point be sure that the type of those parameters are defined properly in your source code In VB6 we use single declaration type to do it For example 13 Dim VariableName as Single Or Public VariableName as Single 2 Reflectance values are values This means that all values are between 0 to 100 Examples Anyname REFLACTANCE40 LOWERCASExyz CALCULATE Array40 D65 10 Resultx Resulty Resultz X y Z chromaticity values under illuminant Daylight 6500K and 10 degree observer of the color in Array40 will be returned via variables Resultx Resulty and Resultz consecutively Anyname REFLACTANCEA0 CAPITALXYZ CALCULATE RefArray40 CWF 2 Crmtctx Crmtcty Crmtctz X y 7 chromaticity values under illuminant Coolwhite 4150K and 2 degree observer of the color in Array40 will be returned via variables Crmtctx Crmtety and Crmtctz cosecutively 14 Subroutine no 5 Subroutine name REFLECTANCEA0 CIELab CALCULATE Description Calculates L a b values in CIE coordinate system CIELab color space from reflectance values of a color Purpose Send reflectance values between 360nm 750nm with 10nm interval 40 pcs and get L a and b values for CIE coordinate CIELab color space system General form REFLECTANCE40_CIELab_CALCULATE Reflectance40 As Single LightSource As String Observe
100. l the output parameters may be like below Result OKEY Mode 2 UV 00100 Type 6 Name Color 1A Spacez L a b Light12 D65 Light2 A Observer 10 Values 1 12 23 Values 2 0 14 Values 3 4 51 gt L a b values for the illuminant D65 Values 4 2 3 Values 5 1 34 Values 6 8 1 gt L a b values for the illuminant A If the operation is not successful then you get an error message in Result variable Result FAIL No communication Subroutine no 8 Subroutine name UPLOAD Description Uploads a color into the instrament s memory Purpose Specify a memory adress and upload the values of a color into that location General form UPLOAD ComObject As Object ComPortNo As Byte Instrument As Byte Adress As Integer ColorName As String Reflectance40 As Single As String Input parameters Parameter 1 gt ComObject As Object Obejct full name of serial communication object Name of the MsComm object in the form For example Assume that a form namely Form1 and a MsComm object on it namely MsComm1 In this case this parameter will be like this Form1 MsComml Parameter 2 s ComPortNo As Byte A number between 1 to 255 indicating port number of serial commnunication channel Parameter 3 gt Instrument As Byte A number indicating which instrument you use See SUPPORTED INSTRUMENT SELECTION TABLE at the end of this document Parameter 4 s Adress as
101. le with a name given with this parameter For example let s assume that you assigned RECIPES name with this parameter and DLL has calculated more then one alternative recipies with different combinations with different dyes you passed then recipes will be stored automatically RECIPES 1 TXT RECIPES2 TXT RECIPESn TXT etc You can also specify a name including path Each text file has only one recipe alternatives with the same format as follows DYE 1 C 0 05575 DYE 3 C 0 00198 DYE 4 oC 0 21448 Targeted reflectances 400 700nm gt 14 81 11 30 9 09 8 06 8 26 9 48 10 35 10 02 8 70 7 37 6 21 5 33 4 77 4 40 4 25 4 37 4 67 4 88 4 85 4 45 3 66 2 80 2 26 2 19 2 66 4 02 6 99 12 29 20 20 30 12 41 63 Calculated reflectances 400 700nm gt 15 11 12 22 10 08 8 96 8 09 7 69 7 87 7 75 7 49 7 36 7 44 7 68 8 24 9 11 10 44 12 42 15 28 19 09 23 99 29 94 36 50 43 22 49 69 55 08 59 34 62 53 64 65 65 91 66 62 66 94 67 14 CIELab DELTA E D65 62 63 Let s explain the content of these text files First three lines represents dye number and corresponding amount of it as C The number of dyes will vary according to input parameter NumberOfDyesInEachRecipe naturally The line Targeted reflectances 400 700nm represent reflectance values given in input parameter array TargetColorReflectance31 The line Calculated refle
102. leName as Single 2 Output parameters Result Hunter DELTAL Result Hunter DELTAa and Result Hunter DELTAb may return plus or minus value so be sure that variable has been defined properly in your code Examples Anyname HUNTER DELTA CALCULATEC 11 12 3 06 2 17 12 09 3 21 1 16 DiffL Diffa Diffb DiffE The differences in Hunter color space between standard color L 11 12 a 3 06 b 2 17 and trial color L 12 09 a 3 21 b 1 16 will be calculated and differences between these two colors will be output via variables DiffL Diffa Diffb and DiffE Anyname HUNTER DELTA CALCULATE 71 12 13 46 21 17 70 09 13 30 21 10 CIELab DL HUnterLab Da HunterLab Db HunterLab Da The differences in Hunter color space between standard color L 71 12 a 13 46 bz21 17 and trial color L 70 09 a 13 30 b 21 10 will be calculated and differences between these two colors will be output via variables HunterLab DL HunterLab Da HunterLab Db and HunterLab DE 22 Subroutine no 9 Subroutine name REFLECTANCE40 CMC CALCULATE Description Calculates L a b C chroma and H hue values in CMC color space from reflectance values of a color Purpose Send reflectance values between 360nm 750nm with 10nm interval 40 pcs and get L a b C and H values for CMC color space General form REFLECTANCE40 CMC CALCULATE Reflectance40 As Single LightSource As String Observer As Byte Result CMC L As Single Result CMC a A
103. lueish difference value between two colors specified Parameter 4 gt Result CMC DELTAC As Single Returns CMC color space DELTAC Chroma difference value between two colors specified Parameter 5 gt Result CMC DELTAhl As Single Returns CMC color space DELTAh1 Mathematical difference of H value between two colors specified Parameter 6 s Result CMC DELTAH As Single Returns CMC color space DELTAH Calculated difference of H value between two colors specified Parameter 6 gt Result CMC DELTAE As Single Returns CMC color space DELTAE total difference value between two colors specified Notes 1 As all output numeric parameters has decimal point be sure that the type of those parameters are defined properly in your source code In VB6 we use single declaration type to do it For example Dim VariableName as Single or Public VariableName as Single 2 Output parameters Result CMC DELTAL Result_CMC_DELTAa Result_CMC_DELTAb and Result CMC DELTAC may return plus or minus values Please be sure these parameters type is declared properly in your code 28 Examples Anyname CMC DELTA CALCULATK 1 1 12 3 06 2 17 12 09 3 21 11 16 3 82 1 99 11 99 3 18 2 DiffL Diffa Diffb DiffC Diffh1 DiffH DiffE The differences between standard color L 11 12 a 3 06 b 2 17 C 12 09 H 3 21 and trial color L 11 16 a 3 82 b 1 99 C 11 99 H 3 18 will be calculated according to l c ratio 2 and diffe
104. m reflectance gt DYE 3 3 shade 690nm reflectance gt DYE 3 3 shade 700nm reflectance 75 Later DyeShadesReflectance31 3 4 1 20 3 DYE 3 4 shade concentration DyeShadesReflectance31 3 4 2 220 065 gt DYE 3 4 shade 400nm reflectance DyeShadesReflectance31 3 4 3 216 115 gt DYE 3 4 shade 410nm reflectance DyeShadesReflectance31 3 4 31 2 73 43 gt DYE 3 4 shade 690nm reflectance DyeShadesReflectance31 3 4 32 2 73 92 gt DYE 3 4 shade 700nm reflectance Later DyeShadesReflectance31 3 5 1 0 DYE 3 5 shade is absent DyeShadesReflectance31 3 5 2 0 gt DYE 3 5 shade is absent DyeShadesReflectance31 3 5 3 2 0 gt DYE 3 5 shade is absent DyeShadesReflectance31 3 5 31 2 0 DYE 3 5 shade is absent DyeShadesReflectance3 1 3 5 32 0 gt DYE 3 5 shade is absent Later DyeShadesReflectance3 1 3 6 1 0 gt DYE 3 6 shade is absent DyeShadesReflectance3 1 3 6 2 0 gt DYE 3 6 shade is absent DyeShadesReflectance31 3 6 3 20 DYE 3 6 shade is absent DyeShadesReflectance31 3 6 31 2 0 gt DYE 3 6 shade is absent DyeShadesReflectance3 1 3 6 32 0 gt DYE 3 6 shade is absent Later DyeShadesReflectance3 1 3 7 1 0 gt DYE 3 7 shade is absent DyeShadesReflectance3 1 3 7 2 0 gt DYE 3 7 shade is absent DyeShadesReflectance3 1 3 7 3 0 gt DYE 3 7 shade is absent DyeShadesReflectance31 3 7 31 2 0 gt DYE 3 7 shade is absent DyeShadesReflectance3 1 3 7 32 0 gt DYE 3 7 shad
105. me CIELab_METAMERISM_CALCULATE Description Calculates metamerism color difference change between two different light source Purpose Send L a b values in CIELab color space for two colors and get how the color difference is changing under different illuminats metamerism General form CIELab METAMERISM CALCULATE CIE Ll Std As Single CIE al Std As Single CIE bl Std As Single CIE Ll Trial As Single CIE al Trial As Single CIE bl Trial As Single CIE L2 Std As Single CIE a2 Std As Single CIE b2 Std As Single CIE L2 Trial As Single CIE a2 Trial As Single CIE b2 Trial As Single Result Metamerism As Single Input parameters Parameter 1 gt CIE L1 Std As Single L value CIELab under first light source of the first color Parameter 2 gt CIE 21 Std As Single a value CIELab under first light source of the first color Parameter 3 gt CIE b1 Std As Single b value CIELab under first light source of the first color Parameter 4 gt CIE L1 Trial As Single L value CIELab under first light source of the second color Parameter 5 gt CIE a1 Trial As Single a value CIELab under first light source of the second color Parameter 6 gt CIE b1 Trial As Single b value CIELab under first light source of the second color Parameter 7 5 CIE L2 Std As Single L value CIELab under second light source of the first color Parameter 8 gt CIE 22 Std As Single a value CIELab under second light source of the first
106. ncentration DyeShadesReflectance31 4 1 2 251 15 gt DYE 4 1 shade 400nm reflectance DyeShadesReflectance31 4 1 3 249 665 gt DYE 4 1 shade 410nm reflectance DyeShadesReflectance31 4 1 31 2 72 79 gt DYE 4 1 shade 690nm reflectance DyeShadesReflectance31 4 1 32 2 72 945 DYE 4 1 shade 700nm reflectance Later DyeShadesReflectance31 4 2 1 20 075 gt DYE 4 2 shade concentration DyeShadesReflectance31 4 2 2 51 12 gt DYE 4 2 shade 400nm reflectance DyeShadesReflectance31 4 2 3 248 85 gt DYE 4 2 shade 410nm reflectance DyeShadesReflectance31 4 2 31 2 74 475 gt DYE 4 2 shade 690nm reflectance DyeShadesReflectance31 4 2 32 2 74 62 gt DYE 4 2 shade 700nm reflectance Later DyeShadesReflectance31 4 3 1 20 1 gt DYE 4 3 shade concentration DyeShadesReflectance31 4 3 2 247 435 gt DYE 4 3 shade 400nm reflectance DyeShadesReflectance31 4 3 3 244 16 gt DYE 4 3 shade 410nm reflectance DyeShadesReflectance31 4 3 31 2 73 735 gt DYE 4 3 shade 690nm reflectance DyeShadesReflectance31 4 3 32 2 73 875 gt DYE 4 3 shade 700nm reflectance Later DyeShadesReflectance31 4 4 1 20 2 gt DYE 4 4 shade concentration DyeShadesReflectance31 4 4 2 40 4 gt DYE 4 4 shade 400nm reflectance DyeShadesReflectance31 4 4 3 235 33 gt DYE 4 4 shade 410nm reflectance DyeShadesReflectance31 4 4 31 2 72 705 gt DYE 4 4 shade 690nm reflectance DyeShadesReflectance31 4 4 32 2 73 40 gt DYE 4 4 shade 700nm re
107. nd b CIELab values for both samplel and sample2 and get DELTA L DELTA a DELTA b and DELTA E values in CIE coordinate system General form CIELab DELTA CALCULATE CIELab L Std As Single CIELab a Std As Single CIELab b Std As Single CIELab L Trial As Single CIELab a Trial As Single CIELab b Trial As Single Result CIELab DELTAL As Single Result CIELAB DELTAa As Single Result CIELab DELTAb As Single Result CIELab DELTAE As Single Input parameters Parameter 1 gt CIELab L Std As Single Lightness value L CIELab color space of the standard color 100 represents lightest color and 0 zero represents darkest colors Parameter 2 gt CIELab a Std As Single Greenish Redish value a CIELab color space of the standard color Minus values represent green zone Plus values represent red zone Parameter 3 gt CIELab b Std As Single Yellowish Blueish value b value CIELab color space of the standard color Minus values represent blue zone Plus values represent yellow zone Parameter 4 s CIELab L Trial As Single Lightness value L CIELab color space of the trail sample color 100 represents lightest color and 0 zero represents darkest colors Parameter 5 gt CIELab a Trial As Single Greenish Redish value a CIELab color space of the trail sample color Minus values represent green zone Plus values represent red zone Parameter 6 gt CIELab b Trial As Single Yellowish Blueish value b CIELab
108. ngle Returns a red value between 0 255 corresponding to the color given in array REFLECTANCE40 as input parameter Parameter 2 gt Result_Green As Single Returns a green value between 0 255 corresponding to the color given in array REFLECTANCE40 as input parameter Parameter 3 gt Result_Blue As Single Notes Examples Returns a blue value between 0 255 corresponding to the color given in array REFLECTANCEAO as input parameter Anyname REFLECTANCE40_RGB_CALCULATE ColorrefArray Red1 Green1 Blue1 Three values between 0 and 255 will be returned via output variables Redl Green1 81061 for the color given in array ColorrefArray as input Anyname REFLECTANCEA40 RGB CALCULATE CustomerSample cR cG cB Three values between 0 and 255 will be returned via output variables cR cG cB for the color given in array CustomerSample 30 Subroutine no 13 Subroutine name CIELab RGB CALCULATE Description Calculates R red G Green B Blue values from the color given with L a and b values at CIELab color space under a certain light source and observer Purpose Send L a and b values at CIELab color space and get R G B values of it General form CIELab RGB CALCULATE CIE L As Single CIE a As Single CIE b As Single LightSource As String Observer As Byte Result Red As Single Result Green As Single Result Blue As Single Input parameters Parameter 1 gt CIE L As Single L Lightness value
109. nts 4 0 Amounts 5 0 Amounts 6 0 98 Output parameters Parameter 1 gt Parameter 1 gt Notes Examples Result Reflectance40 As Single 3 element array consist of Calculated reflectance values 360nm 750nm of the color mixed resulting the recipe given in parameters Result Error As String This is a string whose length is equal to number of dyes passed to this function For example if you have passed three dyes to the function then this parameter will return a string with 3 caharacters This output parameter shows that the calculated result is trustable or not Each character of this parameter can only have one four information These are 0 1 2 or W The place of these informations refers the number of dye Another saying that first digit represents the first dye second digit represents the second dye third digit represents the third dye and so on 0 means that the no problem has been encountered for that dye in order 1 indicates a problem This generally occurs when the minimum c of the shades of the dye is not as small as required The solution is to improve dye file by preparing new shades with smaller c then existing minimum c 2 indicates a problem This generally occurs when the maximum c of the shades of the dye is not as big as required The solution is to improve dye file by preparing new shades with bigger c then existing maximum oc VV indicates
110. operly in your code Examples Anyname REFLECTANCE40_HUNTERLab_CALCULATE RedTT 100 D65 10 Result_L Result_a Result_b L a b values of HunterLab color space under illuminant Daylight 6500K and 10 degree observer of the color in Array RedTT10 will be returned via variables Result_L Result_a and Result_b consecutively Anyname REFLECTANCE40 CIELab CALCULATE Sample 10 U30 10 Hunter_L Hunter a Hunter b L a b values of HunterLab color space under illuminant Ultralume 30 3000K and 10 degree observer of the color in array Samplel will be returned via variables HunterLab L Hunterlab a and HunterLab _b consecutively 20 Subroutine no 8 Subroutine name HUNTER DELTA CALCULATE Description Calculates Delta L DELTA a DELTA b and DELTA E values in HunterLab color Space from two sets of color Sample Standard vs Trial reflectance values Purpose Send L HunterLab a HunterLab and b HunterLab values for both samplel and sample2 and get DELTA L DELTA a DELTA b and DELTA E values in HunterLab color space General form HUNTER DELTA CALCULATE Hunter L Std As Single Hunter a Std As Single Hunter b Std As Single Hunter L Trial As Single Hunter a Trial As Single Hunter b Trial As Single Result HUNTER DELTAL As Single Result HUNTER DELTAa As Single Result HUNTER DELTAb As Single Result HUNTER DELTAE as Single Input parameters Parameter 1 gt Hunter L Std As Single L value HunterL
111. output via variable Result WI 41 Subroutine no 19 Subroutine name REFLECTANCEA0 TINT CALCULATE Description Calculates both TINT value Ganz Griesser and E313 for the color given in array REFLECTANCEAO Purpose Send reflectance values between 360nm 750nm with 10nm intervals 40 pcs and get TINT values General form REFLECTANCEA0 TINT CALCULATE Reflectance40 As Single Result TintGG As Single Result TintE313 As Single Input parameters Parameter 1 gt Reflectance40 as Single Any array with 40 elements having reflectance values between 360nm 750nm with 10nm intervals Example Refs 1 212 345 Reflectance value for 360nm Refs 2 11 395 Reflectance value for 370nm Refs 39 32 123 Reflectance value for 740nm Refs 40 36 523 Reflectance value for 750nm Output parameters Parameter 1 s Result TintGG As Single Ganz Griesser Tint value for the color given in the array REFLECTANCE40 Parameter 1 gt Result E313 As Single E313 Tint value for the color given in array REFLECTANCE40 Notes 1 As all output numeric parameters has decimal point be sure that the type of those parameters are defined properly in your source code In VB6 we use single declaration type to do it For example Dim VariableName as Single Or Public VariableName as Single Examples Anyname REFLECTANCEA0 TINT CALCULATE SampleTest Result T1 Result T2 TINT values for the color given in array SampleTest will be output via va
112. r C CMC color space of the standard color Parameter 5 gt CMC II Std As Single Hue value H Pureness CMC color space of the standard color Parameter 6 gt CMC L Trial As Single Lightness value L CMC color space of the trial sample color 100 represents lightest color and 0 zero represents darkest colors Parameter 7 gt CMC_a_Trial As Single Greenish Redish value a CMC color space of the trial sample color Minus values represent green zone Plus values represent red zone 27 Parameter 8 s CMC b Trial As Single Yellowish Blueish value b value CMC color space of the trial sample color Minus values represent blue zone and plus values represent yellow zone Parameter 9 gt CMC C Trial As Single Chroma Duller Sharper value C CMC color space of the trial sample color Parameter 10 gt CMC H Trial As Single Hue Pureness value H CMC color space of the trial sample color Parameter 11 2 LC Ratio As Byte Acceptability Perceptability factor L c 1 for Lic 1 1 2 for L cz2 1 Output parameters Parameter 1 s Result CMC DELTAL As Single Returns CMC color space DELTAL Lightness difference value between two colors specified Parameter 2 gt Result CMC DELTAa As Single Returns CMC color space DELTAa Greenish Redish difference value between two colors specified Parameter 3 gt Result CMC DELTAb As Single Returns CMC color space DELTAb Yellowish B
113. r As Byte Result CIE L As Single Result CIE a As Single Result CIE b As Single Input parameters Parameter 1 gt Reflectance40 as Single Any array with 40 elements having reflectance values between 360nm 750nm with 10nm intervals Example Refs 1 212 345 Reflectance value for 360nm Refs 2 11 395 Reflectance value for 370nm Refs 39 32 123 Reflectance value for 740nm Refs 40 236 523 Reflectance value for 750nm Parameter 2 gt LightSource As String One of the options from LIGHT SOURCES SELECTION REFERENCE TABLE at the end of this document to tell the subroutine which light source will be used simulated to calculate CIE L a and b values Parameter 3 gt Observer as Byte One of the options below to tell the subroutine which observer for the specified light source will be used to calculate CIE L a and b values 2 Weighing factors for 2 degree observer will be used 10 gt Weighing factors for 10 degree observer will be used Output parameters Parameter 1 gt Result CIE L As Single Returns Lightness value L in CIE coordinate system L value is between 0 to 100 100 represents lightest color and 0 zero represents darkest colors Parameter 2 gt Result CIE a As Single Returns Greenish Redish value a in CIE coordinate system Minus values represent green zone Plus values represent red zone Parameter 3 s Result CIE b As Single Returns Yellowish Blueish value b in CIE coordinate system
114. r code it will detect dongle and if it is not exist it will terminate itself So your software will be protected against pricy also SECTIONI Function Description Section This chapter describes each subroutine in DLL Readme first 1 Each subroutine is named according to same format as follows to ensure better understanding for users during coding Subroutines names say us what will be converted from and to First part of the name shows what will be converted from inputs of subroutine Second part of the name shows what will be converted to output of subroutine Example 1 REFLECTANCE40 CAPITALXYZ CALCULATE means that At a glance we can easily understand what does this subroutine do This subroutine converts reflectance values to X Y Z trsitimulus values First part is REFLECTANCE40 shows us this subroutine accepts 40 pieces reflectance values as input Second part is CAPITALX YZ shows us this subroutine will send back CAPITAL X Y Z values known as tristimulus as output Example 2 CIELab CMC CALCULATE means that At a glance we can easily understand what does this subroutine do also This subroutine converts CIELab to CMC color space First part is CIELab shows us this subroutine accepts L a b values in CIELab color space as input Second part is CMC shows us this subroutine will send back L a b C H values for CMC color space 2 The numbers suffix at the end of parts has special meaning as follows 40 mean
115. rences between these two colors will be output via variables DiffL Diffa Diffb DiffC Diffh1 DiffH and DiffE Anyname CMC DELTA CALCULATE 71 12 13 46 21 17 70 09 134 30 70 92 14 56 19 92 71 19 138 71 1 CMC DL CMC Da CMC Db CMC DC CMC Dhl CMC DH CMC DE The differences between standard color L 71 12 a 13 46 b 21 17 C 70 09 H 134 30 and trial color L 70 92 a 14 56 bz19 92 Cz71 19 H 138 71 will be calculated according to l c ration 1 and differences between these two colors will be output via variables CMC DL CMC Da CMC Db CMC DC CMC Dhl CMC DH and CMC DE 29 Subroutine no Subroutine name Description Purpose General form Input parameters 12 REFLECTANCEA40 RGB CALCULATE Calculates R red G Green B blue values from the color given in array REFLECTANCEAO Send reflectance values between 360nm 750nm with 10nm interval 40 pcs and get R G B values REFLECTANCEA0 RGB CALCULATE Reflectance40 As Single Result Red As Single Result Green As Single Result Blue As Single Parameter 1 gt Reflectance40 as Single Any array with 40 elements having reflectance values between 360nm 750nm with 10nm intervals Example Refs 1 12 345 Reflectance value for 360nm Refs 2 11 395 Reflectance value for 370nm Refs 39 32 123 Reflectance value for 740nm Refs 40 36 523 Reflectance value for 750nm Output parameters Parameter 1 gt Result_Red As Si
116. riable Result T1 Ganz Griesser and Result T2 E313 Anyname REFLECTANCEA0 TINT CALCULATE LabBatch Result TINTI Result TINT2 TINT values for the color given in array SampleTest will be output via variable Result TINT1 Ganz Griesser and Result TINT2 E313 42 Subroutine no 20 Subroutine name CAPITALXYZ TINT CALCULATE Description Calculates both TINT value Ganz Griesser and E313 for the color given with tristimulus X Y and Z values Purpose Send tristimulus X Y and Z values and get TINT values General form CAPITALXYZ TINT CALCULATE CAPITAL X As Single CAPITAL Y As Single CAPITAL Z As Single Result TintGG As Single Result TintE313 As Single Input parameters Parameter 1 gt CAPITAL X As Single Tristimulus X value of the color see NOTES Term 2 of this subroutine Parameter 2 gt CAPITAL Y As Single Tristimulus Y value of the color see NOTES Term 2 of this subroutine Parameter 3 gt CAPITAL Z As Single Tristimulus Z value of the color see NOTES Term 2 of this subroutine Output parameters Parameter 1 s Result TintGG As Single Ganz Griesser Tint value for the color given with tristimulus X Y and Z values Parameter 2 Result E313 As Single E313 Tint value for the color given with tristimulus X Y and Z values Notes 1 As all output numeric parameters has decimal point be sure that the type of those parameters are defined properly in your source code In VB6 we use single d
117. s 39 32 123 Reflectance value for 740nm Refs 40 236 523 Reflectance value for 750nm Parameter 2 s WhitenessType As Byte Any integer number according to following list to get the desired whiteness index standard Selection value Meaning 1 2 3 E313 whiteness index CIE whiteness index under illuminant D65 with 2 degree observer CIE whiteness index under illuminant D65 with 10 degree observer Berger whiteness index under illuminant D65 with 2 degree observer Berger whiteness index under illuminant D65 with 10 degree observer Stensby whiteness index Taube whiteness index Ganz whitenes index 38 Output parameters Parameter 1 s Result Whiteness As Single Calculated Whiteness index according to color given in array REFLACTANCE40 and the selected WhhitenessType parameter Notes 1 As all output numeric parameters has decimal point be sure that the type of those parameters are defined properly in your source code In VB6 we use single declaration type to do it For example Dim VariableName as Single or Public VariableName as Single Examples Anyname REFLECTANCE40_WHITENESS_CALCULATE Samplel 3 Result WI CIE whiteness index under illuminant D65 and 10 degree for the color given in array Samplel will be output via variable Result WI Anyname REFLECTANCEA40 WHITENESS CALCULATE SampleRef 6 Result WI Stensby index for the color given in array SampleRef will be output via variable Re
118. s 40 pieces value between 360nm 750nm with 10nm interval 3 means 31 pieces value between 400 700 nm with 10nm interval Example REFLECTANCE40 gt Means an array with 40 elements containing reflectance values between 360nm 750nm with 10nm intervals REFLECTANCE31 gt Means an array with 31 elements containing reflectance values between 400nm 700nm with 10nm intervals These naming rules are applied to all parameters in subroutines in DLL to help the user understand the function at a glance and use it immediately without reading the documents each time Subroutine no 21 Subroutine name REFLECTANCE40 CAPITALXYZ CALCULATE Description Calculates X Y and Z tristimulus values from reflectance values of a color Purpose Send reflectance values between 360nm 750nm with 10nm interval 40 pcs and get X Y Z tristimulus values General form REFLACTANCEA0 CAPITALXYZ CALCULATE Reflectance40 As Single LightSource As String Observer As Byte Result CAPITAL X As Single Result CAPITAL Y As Single Result CAPITAL Z As Single Input parameters Parameter 1 gt Reflectance40 as Single Any array with 40 elements having reflectance values between 360nm 750nm with 10nm intervals Example Refs 1 212 345 Reflectance value for 360nm Refs 2 11 395 Reflectance value for 370nm Refs 39 32 123 Reflectance value for 740nm Refs 40 236 523 Reflectance value for 750nm Parameter 2 gt LightSource As String One of the options
119. s CMC L CMC a CMC b CMC C and CMC H consecutively 24 Subroutine no 10 Subroutine name CIELab CMC CALCULATE Description Calculates L a b C chroma and H hue values in CMC color space from CIELab L a b values of a color Purpose Send L a b values for CIELab color space and get L a b C and H values for CMC color space General form CIELab CMC CALCULATE CIELab L As Single CIELab a As Single CIELab b As Single Result CMC L As Single Result CMC a As Single Result CMC b As Single Result CMC C As Single Result CMC H As Single Input parameters Parameter 1 s CIELab L As Single L Lightness value in CIELab color space 100 represents lightest color and 0 zero represents darkest colors Parameter 2 gt CIELab a As Single a Greenish Redish value in CIELab color space Minus values represent green zone Plus values represent red zone Parameter 3 gt CIELab b Std As Single b Yellowish Blueish value in CIELab color space Minus values represent blue zone Plus values represent yellow zone Output parameters Parameter 1 gt Result CMC L As Single Returns Lightness value L in CMC coordinate system L value is between 0 and 100 100 represents lightest color and 0 zero represents darkest colors Parameter 2 gt Result CMC a As Single Returns Greenish Redish value a in CMC coordinate system Minus values represent green zone Plus values represent red zone Parameter 3 gt Result_CM
120. s Delta L DELTA a DELTA b DELTA C DELTA H and DELTA E values in CMC color space from two sets of color Sample Standard vs Trial specifed with CMC L CMC a CMC b CMC C and CMC H values Purpose Send L CMC a CMC b CMC C CMC and H CMC values for both samplel and sample2 and get DELTA L DELTA a DELTA b and DELTA E values in CMC color space General form CMC DELTA CALCULATE CMC L Std As Single CMC a Std As Single CMC b Std As Single CMC C Std As Single CMC H Std As Single CMC L Trial As Single CMC a Trial As Single CMC b Trial As Single CMC C Trial As Single CMC II Trial As Single LC Ratio As Byte Result CMC DELTAL As Single Result CMC DELTAa As Single Result CMC DELTAb As Single Result CMC DELTAC As Single Result CMC DELTARI As Single Result CMC DELTAH As Single Result CMC DELTAE As Single Input parameters Parameter 1 gt CMC L Std As Single Lightness value L CMC color space of the standard color 100 represents lightest color and 0 zero represents darkest colors Parameter 2 gt CMC a Std As Single Greenish Redish value a CMC color space of the standard color Minus values represent green zone Plus values represent red zone Parameter 3 gt CMC b Std As Single Yellowish Blueish value b value CMC color space of the standard color Minus values represent blue zone Plus values represent yellow zone Parameter 4 gt CMC C Std As Single Chroma value Duller Sharpe
121. s Single Result CMC b As Single Result CMC C As Single Result CMC H As Single Input parameters Parameter 1 gt Reflectance40 as Single Any array with 40 elements having reflectance values between 360nm 750nm with 10nm intervals Example Refs 1 212 345 Reflectance value for 360nm Refs 2 11 395 Reflectance value for 370nm Refs 39 32 123 Reflectance value for 740nm Refs 40 236 523 Reflectance value for 750nm Parameter 2 gt LightSource As String One of the options from LIGHT SOURCES SELECTION REFERENCE TABLE at the end of this document to tell the subroutine which light source will be used simulated to calculate CMC L CMC a CMC b CMC C and CMC H values Parameter 3 gt Observer as Byte One of the options below to tell the subroutine which observer for the specified light source will be used to calculate Hunter L a and b values 2 Weighing factors for 2 degree observer will be used 10 gt Weighing factors for 10 degree observer will be used Output parameters Parameter 1 gt Result_CMC_L As Single Returns Lightness value L in CMC coordinate system L value is between 0 and 100 100 represents lightest color and 0 zero represents darkest colors Parameter 2 gt Result_CMC_a As Single Returns Greenish Redish value a in CMC coordinate system Minus values represent green zone Plus values represent red zone Parameter 3 gt Result_CMC_b As Single Returns Yellowish Blueish value
122. sult WI 2 39 Subroutine no IS Subroutine name CAPITALXYZ WHITENESS CALCULATE Description Calculates one of the following whiteness index for the color given with X Y and tristimulus value Supported Whiteness index types WLIE313 WI CIE D65 2 degree WI CIE D65 10 degree WI Berger D65 2 degree WI Berger D65 10 degree WI Taube WI Ganz Purpose Send X Y and Z tristimulus values and get Whiteness index General form CAPITALXYZ WHITENESS CALCULATE CAPITAL X As Single CAPITAL Y As Single CAPITAL Z As Single WhitenessType As Byte Result Whiteness As Single Input parameters Parameter 1 gt CAPITAL X As Single Tristimulus X value of the color see NOTES Term 2 of this subroutine Parameter 2 gt CAPITAL Y As Single Tristimulus Y value of the color see NOTES Term 2 of this subroutine Parameter 3 gt CAPITAL Z As Single Tristimulus Z value of the color see NOTES Term 2 of this subroutine Parameter 4 gt WhitenessType As Byte Any integer number according to following list to get the desired whiteness index value Selection value Meaning 1 E313 whiteness index 2 CIE whiteness index under illuminant D65 with 2 degree observer 3 CIE whiteness index under illuminant D65 with 10 degree observer 4 Berger whiteness index under illuminant D65 with 2 degree observer 5 Berger whiteness index under illuminant D65 with 10 degree observer 7 Taube whiteness index 8 Ganz whitenes index O
123. t CAPITAL Y OverWhite As Single Tristimulus Y value of the color over white Parameter 3 gt CAPITAL 7 OverWhite As Single Tristimulus Z value of the color over white Parameter 4 gt CAPITAL X OverBlack As Single Tristimulus X value of the color over black Parameter 5 gt CAPITAL Y OverBlack As Single Tristimulus Y value of the color over black Parameter 6 gt CAPITAL 7 OverBlack As Single Tristimulus Z value of the color over black Parameter 7 gt OpacityType As Byte One of the options below determining opacity type Type Meaning 2 Opacity according to tristimulus Z Suitbale for blue colors 3 Opacity according to tristimulus Y Suitable for green color 4 Opacity according to tristimulus X Suitable for yellow red colors Output parameters Parameter 1 gt Result Opacity As Single Returns opacity value Notes 1 As all output numeric parameters has decimal point be sure that the type of those parameters are defined properly in your source code In VB6 we use single declaration type to do it For example Dim VariableName as Single or Public VariableName as Single 52 Examples Anyname CAPITALXYZ OPACITY CALCULATE 11 23 45 34 56 12 9 12 44 12 55 56 2 Opacity Opacity according to tristimulus Y value of the color specified with tristimulus X Y Z over white and over black will be output via variable opacity Anyname CAPITALXYZ_OPACITY_CALCULATE 4 23 15 34 26 12 5 12 14 12
124. t DYE 2 2 shade 690nm reflectance DyeShadesReflectance31 2 2 32 2 75 48 gt DYE 2 2 shade 700nm reflectance Later DyeShadesReflectance31 2 3 1 20 15 DYE 2 3 shade concentration DyeShadesReflectance31 2 3 2 211 985 gt DYE 2 3 shade 400nm reflectance DyeShadesReflectance31 2 3 3 29 015 gt DYE 2 3 shade 410nm reflectance e e DyeShadesReflectance31 2 3 31 2 74 05 gt DYE 2 3 shade 690nm reflectance DyeShadesReflectance3 1 2 3 32 74 135 gt DYE 2 3 shade 700nm reflectance Later DyeShadesReflectance31 2 4 1 20 5 DYE 2 4 shade concentration DyeShadesReflectance31 2 4 2 24 955 gt DYE 2 4 shade 400nm reflectance DyeShadesReflectance31 2 4 3 23 49 gt DYE 2 4 shade 410nm reflectance e e DyeShadesReflectance31 2 4 31 2 72 585 gt DYE 2 4 shade 690nm reflectance DyeShadesReflectance31 2 4 32 2 72 64 DYE 2 4 shade 700nm reflectance Later DyeShadesReflectance31 2 5 1 21 DYE 2 5 shade concentration DyeShadesReflectance31 2 5 2 22 24 gt DYE 2 5 shade 400nm reflectance DyeShadesReflectance31 2 5 3 21 725 gt DYE 2 5 shade 410nm reflectance e e DyeShadesReflectance31 2 5 31 2 72 355 gt DYE 2 5 shade 690nm reflectance DyeShadesReflectance31 2 5 32 2 72 475 gt DYE 2 5 shade 700nm reflectance 72 Later DyeShadesReflectance31 2 6 1 0 DYE 2 6 shade is absent DyeShadesReflectance31 2 6 2 20 DYE 2 6 shade is absent DyeShadesReflectance31 2 6 3 20 DYE 2
125. t DYE 5 5 shade concentration gt DYE 5 5 shade concentration gt DYE 5 5 shade concentration gt DYE 5 5 shade concentration gt DYE 5 5 shade concentration 83 Later DyeShadesReflectance31 5 6 1 20 5 DYE 5 6 shade concentration DyeShadesReflectance31 5 6 2 232 015 gt DYE 5 6 shade concentration DyeShadesReflectance31 5 6 3 33 345 gt DYE 5 6 shade concentration DyeShadesReflectance31 5 6 31 2 24 185 DYE 5 6 shade concentration DyeShadesReflectance31 5 6 32 2 40 455 gt DYE 5 6 shade concentration Later DyeShadesReflectance31 5 7 1 1 gt DYE 5 7 shade concentration DyeShadesReflectance31 5 7 2 222 775 gt DYE 5 7 shade concentration DyeShadesReflectance31 5 7 3 223 81 DYE 5 7 shade concentration DyeShadesReflectance31 5 7 31 8 955 gt DYE 5 7 shade concentration DyeShadesReflectance31 5 7 32 218 525 gt DYE 5 7 shade concentration Later DyeShadesReflectance31 5 8 1 20 DYE 5 8 shade is absent DyeShadesReflectance31 5 8 2 20 DYE 5 8 shade is absent DyeShadesReflectance31 5 8 3 20 DYE 5 8 shade is absent DyeShadesReflectance31 5 8 31 2 0 gt DYE 5 8 shade is absent DyeShadesReflectance3 1 5 8 32 0 gt DYE 5 8 shade is absent Later DyeShadesReflectance31 5 9 1 0 DYE 5 9 shade is absent DyeShadesReflectance31 5 9 2 0 gt DYE 5 9 shade is absent DyeShadesReflectance31 5 9 3 0 DYE 5 9 shade is absent DyeShadesReflectance31 5 9 31 2 0
126. t DyeShadesReflectance31 6 15 31 2 0 gt DYE 6 15 shade is absent DyeShadesReflectance31 6 15 32 2 0 DYE 6 15 shade is absent Three dimensional array DyeShadesReflectance31 has been filled with necessary values Parameter 2 gt ShadesSubstrateReflectance31 As Single An array with 31 elements having reflectance values between 400nm 700nm with 10nm intervals of the substrate which was used while preparing shades Example ShadesSubstrateReflectance3 1 1 81 345 Reflectance value for 400nm ShadesSubstrateReflectance3 1 2 90 395 Reflectance value for 410nm ShadesSubstrateReflectance3 1 30 94 123 Reflectance value for 690nm ShadesSubstrateReflectance3 1 31 95 523 Reflectance value for 700nm Importantl In order to get more precious recipe calculation the substrate should be processed as Blank Dyeing and then measured Blank dyeing means a dyeing process without dyestuff but also with same chemicals auxiliaries with calibration shades in same machine of calibration shades Because white substrate gets a little tint due to chemicals Parameter 3 gt TargetSubstrateReflectance31 As Single An array with 31 elements having reflectance values between 400nm 700nm with 10nm intervals of the substrate which will be used for dyeing of the recipe to be calculated This substrate may be the same substrate with ShadesSubstrateReflectance31 Example TargetSubstrateReflectance3 1 1 82 345 Reflectance value for 4
127. t Brightness R457 As Single Returns under specified light source and observer R457 brightness value of the color given in array Reflectance40 Notes 1 As all output numeric parameters has decimal point be sure that the type of those parameters are defined properly in your source code In VB6 we use single declaration type to do it For example Dim VariableName as Single or Public VariableName as Single 2 Reflectance values are values This means that all values are between 0 to 100 56 Examples Anyname REFLECTANCEA40 BRIGHTNESS CALCULATE Color10 D65 10 S1 S2 Under light source D65 and 10 degree observer Z brightness in variable S1 and R457 brightness in the variable S2 of the color given in Array Color will be output Anyname REFLECTANCEA40 BRIGHTNESS CALCULATE SampleColor D65 10 ZStr RStr Under light source D65 and 10 degree observer Z brightness in variable ZStr and R457 brightness in Variable Rstr of the color given in Array Color will be output 57 Subroutine no 29 Subroutine name CAPITALXYZ_BRIGHTNESS_CALCULATE Description Calculates Z type brightness value Purpose Send tristimulus X Y and Z values and get Z brightness value General form CAPITALXYZ BRIGHTNESS CALCULATE CAPITAL X As Single CAPITAL Y As Single CAPITAL Z As Single Input parameters Parameter 1 gt CAPITAL X As Single Tristimulus X value of the color Parameter 2 gt CAPITAL Y As Singl
128. t s memory location to be downloaded Output parameters Parameter 1 gt Result Mode as String Returns a number representing the mode of the color in specified memory location 0 2 MAV SCI E 1 gt MAV SCI 2 gt MAV SCE 3 gt SAV SCI E 4 2 SAV SCI 5 2 SAV SCE Parameter 2 gt Result UV As String Returns a string representing the UV setting of the color in specified memory location 091007 gt 100 included lt 400 gt 400nm alti UV bile enler iptal lt gt gt Ayarl UV konumu 120 Parametre 3 gt Result DataType As String Returns a string representing the data type of the values in output parameter Result Reflectance40 39 460 740 aras1 yansima degerleri 6 Hesaplanmis L a ve b de erleri Parameter 4 gt Result Name As String Returns a string representing the name of the color assigned while taking the measurement Parameter 5 gt Result ColorSpace As String Returns a string representing the color space of the color assigned while taking the measurement If the parameter Result DataType is 39 then this parameter does not return any value L a b gt CIElab renk uzay XYZ gt Tristimulus de erleri Hunter Lab gt HunterLab renk uzay Parameter 6 gt Result LightSourcel As String Returns the primary light source which is used to calculate the values in output parameter Result Reflectance40 If the parameter Result DataType is 39 then this par
129. tance values betwwen 360nm 750nm 10nm intervals Parametre 2 gt MEASURE As String The name of this function is also another output parameter and returns a string if the operation has been caried out successfuly or not If measurement opearation has been compeleted successfuly then it wil return OKEY If measurement opearation has not been compeleted successfuly then it wil return FAIL followed by and explanation about reason of failure Example FAIL Instrument is not calibrated Notes 1 The elements of Result_MeasuredReflectance40 array is in string format If you wish to use them in a mathematical calculation do not forget to convert it to numeric format 2 If FAIL information returns with MEASURE output parameter then all elements of Result MeasuredReflectance40 array will return 999 also Example Result Anyname2 MEASURE Form1 MSComm1 2 6 Values KonicaMinolta 3600d instrument will take a measurement via serial port 2 of MsComm1 object on form Form1 The measurement result reflectance values between 400nm 700nm will return via variable Values array with 40 elements Variable Result will also return a string if the measurement was taken successfuly or not 118 Example If the measurement operation was carried out succesfuly then output parameters will be smilar as below ResultZ OKEY Values 1 2 12 34 Olculen 2 2 23 67 Olculen 39 34 12 Olculen 40 30 22
130. tance31 1 3 31 2 76 02 DyeShadesReflectance31 1 3 32 76 23 Later DyeShadesReflectance31 1 4 1 20 05 DyeShadesReflectance31 1 4 2 225 435 DyeShadesReflectance31 1 4 3 221 91 e e DyeShadesReflectance31 1 4 31 75 19 DyeShadesReflectance31 1 4 32 75 255 Later DyeShadesReflectance31 1 5 1 20 1 gt DYE 1 1 shade concentration gt DYE 1 1 shade 400nm reflectance gt DYE 1 1 shade 410nm reflectance gt DYE 1 1 shade 690nm reflectance gt DYE 1 1 shade 700nm reflectance gt DYE 1 2 shade concentration gt DYE 1 2 shade 400nm reflectance gt DYE 1 2 shade 410nm reflectance gt DYE 1 2 shade 690nm reflectance gt DYE 1 2 shade 700nm reflectance gt DYE 1 3 shade concentration gt DYE 1 3 shade 400nm reflectance gt DYE 1 3 shade 410nm reflectance DYE 1 3 shade 690nm reflectance gt DYE 1 3 shade 700nm reflectance gt DYE 1 4 shade concentration gt DYE 1 4 shade 400nm reflectance gt DYE 1 4 shade 410nm reflectance gt DYE 1 4 shade 690nm reflectance gt DYE 1 4 shade 700nm reflectance gt DYE 1 5 shade concentration DyeShadesReflectance31 1 5 2 15 09 gt DYE 1 5 shade 400nm reflectance DyeShadesReflectance31 1 5 3 212 415 gt DYE 1 5 shade 410nm reflectance e e DyeShadesReflectance31 1 5 31 2 73 425 DyeShadesReflectance31 1 5 32 2 73 825 gt DYE 1 5 shade 690nm reflectance gt DYE 1 5 shade 700nm reflectance
131. the form Settings If the command is executed succesfully then variable Status will return OKEY If it is not executed successfuly for a reason then it will return FAIL follwing by an explanation Example FAIL Target RT parameter is wrong 108 Subroutine no 2 Subroutine name SHOW Description Displays a message on instrument display if avilable Purpose To show a message to the user General form SHOW ComObject As Object ComPortNo As Byte Instrument As Byte Size As Byte Statement As String As String Input parameters Parameter 1 gt ComObject As Object Obejct full name of serial communication object Name of the MsComm object in the Form For example Assume that a form namely Form1 and a MsComm object on it namely MsComm1 In this case this parameter will be like this Form1 MsComml Parameter 2 s ComPortNo As Byte A number between 1 to 255 indicating port number of serial commnunication channel Parameter 3 gt Instrument As Byte A number indicating which instrument you use See SUPPORTED INSTRUMENT SELECTION TABLE at the end of this document Parametre 4 gt Size As Byte The character size of text to be displayed ess Normal size Double size Parametre 5 gt Statement As String Message to be displayed If the character size specified is 1 normal size then maximum length is 240 caharcter If the character size specified is 2 double size then maximum length
132. ublic VariableName as Single 3 Output parameters are in string format so be sure that variable has been defined properly in your code Examples Anyname CIELabDELTAE GRAY SCALE CALCULATE 2 17 F1 F2 Wash fastness and staining grade will be calculated according to 2 17 DE difference between two samples and grades will be returned via variables F1 Wash and F2 Staining Anyname CIELabDELTAE GRAY SCALE CALCULATE 1 11 WashF StainingF Wash fastness and staining grade will be calculated according to 1 11 DE difference between two samples and grades will be returned via variables WashF Wash and WashF Staining 49 Subroutine no 25 Subroutine name REFLECTANCEA0 OPACITY CALCULATE Description Calculates opacity of a sample Purpose Send reflectance values between 360nm 750nm with 10nm interval 40 pcs for both samples overblack and overwhite and get opacity value General form REFLECTANCE40 OPACITY CALCULATE Reflectance40 OverBlack As Single Reflectance40 OverWhite As Single LightSource As String Observer As Byte OpacityType As Byte Result Opacity As Single Input parameters Parameter 1 gt Reflectance40 OverBlack As Single An array with 40 elements having reflectance values between 360nm 750nm with 10nm intervals of the sample over black Example Refs 1 212 345 Reflectance value for 360nm Refs 2 11 395 Reflectance value for 370nm Refs 39 32 123 Reflectance value for 740nm Refs 40 23
133. utput parameters Parameter 1 s Result Whiteness As Single Calculated Whiteness index according to color given with tristimulus X Y and Z values and the selected WhitenessType parameter 40 Notes 1 As all output numeric parameters has decimal point be sure that the type of those parameters are defined properly in your source code In VB6 we use single declaration type to do it For example Dim VariableName as Single Or Public VariableName as Single 2 Some of the whiteness indices are calculated under a certain illuminant and observer degree also Please be sure that supplied tristimulus X Y and Z values are obtained under correct illuminant and observer for the whiteness type selected For example E313 whiteness index is only meaningfull under illuminant C and 2 degree observer Table Whiteness index and light source relation table Index name Light Source Observer E313 whiteness index C 2 CIE whiteness index D65 2 or D65 10 Berger whiteness index D65 2 or D65 10 Taube whiteness index D65 10 Ganz whiteness index Any Examples Anyname CAPITALXYZ_WHITENESS_CALCULATE 22 98 41 67 51 09 3 Result WI CIE whiteness index according to tristimulus values X 22 98 Y 41 67 and Z 51 09 for D65 10 will be output via variable Result_WI Anyname CAPITALXYZ VHITENESS CALCULATE 19 23 44 12 26 17 4 Result WI Stensby whiteness index according to tristimulus values X 19 23 Y 44 12 and Z 26 17 for D65 2 will be
134. value will be calculated for the KS 4 16 and result will be output via variable REF Result Anyname KS_ REFLECTANCE CONVERT 41 65 Reflectance value will be calculated for the KS 41 65 and result will be output via variable Result 96 Subroutine no 37 Subroutine name CIELab_DELTA_ASSESSMENTS Description Returns the reason of difference between two colors Purpose Send CIELab values of two color and get the reason of differences General form CIELab_DELTA_ASSESSMENTS L_std As Single a std As Single b std As Single L Trial As Single a Trial As Single b Trial As Single Result Commentl As String Result Comment2 As String Result Comment3 As String Input parameters Parameter 1 s L std As Single L Lightness value at CIELab colorspace of the first color Parameter 2 a std As Single a Red Green value at CIELab colorspace of the first color Parameter 3 gt b std As Single b Blue Yellow value at CIELab colorspace of the first color Parameter 4 5 L std As Single L Lightness value at CIELab colorspace of the second color Parameter 5 a std As Single a Red Green value at CIELab colorspace of the second color Parameter 6 5 b std As Single b Blue Yellow value at CIELab colorspace of the second color Output parameters Parameter 1 gt Result Commentl As String Returns one of two different strings Lighter or Darker Parameter 2 gt Result Comment2 As String Returns one of

user manual ser manual ser manual - Artoksi Mühendislik Sanatlarý

Contents

Download Pdf Manuals

Related Search

Related Contents

user manual ser manual ser manual - Artoksi M&uuml;hendislik Sanatlar&yacute;

Contents

Download Pdf Manuals

Related Search

Related Contents

user manual ser manual ser manual - Artoksi Mühendislik Sanatlarý