/usr/include/dcmtk/dcmimgle/diciefn.h is in libdcmtk-dev 3.6.2-3build3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 | /*
*
* Copyright (C) 1998-2014, OFFIS e.V.
* All rights reserved. See COPYRIGHT file for details.
*
* This software and supporting documentation were developed by
*
* OFFIS e.V.
* R&D Division Health
* Escherweg 2
* D-26121 Oldenburg, Germany
*
*
* Module: dcmimgle
*
* Author: Joerg Riesmeier
*
* Purpose: DicomCIELABFunction (Header)
*
*/
#ifndef DICIEFN_H
#define DICIEFN_H
#include "dcmtk/config/osconfig.h"
#include "dcmtk/dcmimgle/didispfn.h"
#include "dcmtk/dcmimgle/dicielut.h"
/*---------------------*
* class declaration *
*---------------------*/
/** Class to manage CIELAB LUTs (for calibration)
*/
class DCMTK_DCMIMGLE_EXPORT DiCIELABFunction
: public DiDisplayFunction
{
public:
/** constructor, read device characteristics file.
* Keywords: "max" for maximum DDL (Digital Driving Level, required at first position)
* "amb" for ambient light and "lum" for illumination (both optional)
* "ord" for the order of the polynomial curve fitting algorithm used to interpolate
* the given base points (0 or absent = use cubic spline interpolation)
*
** @param filename name of the characteristics file (luminance/OD for each DDL)
* @param deviceType type of the output device (default: monitor)
* @param ord order of the polynomial curve fitting algorithm used to interpolate
* the given base points (-1 = use file setting, 0 = cubic spline)
*/
DiCIELABFunction(const char *filename,
const E_DeviceType deviceType = EDT_Monitor,
const signed int ord = -1);
/** constructor, use given array of luminance/OD values. UNTESTED
* Values must be sorted and complete (i.e. there must be an entry for each DDL)
* The given arrays are copied internally.
*
** @param val_tab pointer to array with luminance/OD values
* @param count number of array elements (should be equal to 'max + 1')
* @param max maximum DDL (digital driving level)
* @param deviceType type of the output device (default: monitor)
* @param ord order of the polynomial curve fitting algorithm used to interpolate
* the given base points (0 or negative = use cubic spline interpolation)
*/
DiCIELABFunction(const double *val_tab,
const unsigned long count,
const Uint16 max = 255,
const E_DeviceType deviceType = EDT_Monitor,
const signed int ord = 0);
/** constructor, use given array of DDL and luminance values. UNTESTED
* Values will be automatically sorted and missing values will be interpolated.
* The given arrays are copied internally.
*
** @param ddl_tab pointer to array with DDL values (must be with the interval 0..max)
* @param val_tab pointer to array with luminance/OD values
* @param count number of array elements (2..65536)
* @param max maximum DDL (digital driving level)
* @param deviceType type of the output device (default: monitor)
* @param ord order of the polynomial curve fitting algorithm used to interpolate
* the given base points (0 or negative = use cubic spline interpolation)
*/
DiCIELABFunction(const Uint16 *ddl_tab,
const double *val_tab,
const unsigned long count,
const Uint16 max = 255,
const E_DeviceType deviceType = EDT_Monitor,
const signed int ord = 0);
/** constructor, compute luminance/OD values automatically within the specified range.
*
** @param val_min minimum luminance/OD value
* @param val_max maximum luminance/OD value
* @param count number of DDLs (digital driving level, 1..65536))
* @param deviceType type of the output device (default: monitor)
* @param ord order of the polynomial curve fitting algorithm used to interpolate
* the given base points (0 or negative = use cubic spline interpolation)
*/
DiCIELABFunction(const double val_min,
const double val_max,
const unsigned long count = 256,
const E_DeviceType deviceType = EDT_Monitor,
const signed int ord = 0);
/** destructor
*/
virtual ~DiCIELABFunction();
/** write curve data to a text file
*
** @param filename name of the text file to which the data should be written
* @param mode write CC and PSC to file if OFTrue
*
** @return status, true if successful, false otherwise
*/
int writeCurveData(const char *filename,
const OFBool mode = OFTrue);
protected:
/** create CIELAB LUT with specified number of entries
*
** @param count number of LUT entries
*
** @return pointer to created LUT if successful, NULL otherwise
*/
DiDisplayLUT *getDisplayLUT(unsigned long count);
private:
// --- declarations to avoid compiler warnings
DiCIELABFunction(const DiDisplayFunction &);
DiCIELABFunction &operator=(const DiDisplayFunction &);
};
#endif
|