/usr/include/dcmtk/dcmimgle/diluptab.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 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 | /*
*
* Copyright (C) 1996-2011, 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: DicomLookupTable (Header)
*
*/
#ifndef DILUPTAB_H
#define DILUPTAB_H
#include "dcmtk/config/osconfig.h"
#include "dcmtk/dcmdata/dctagkey.h"
#include "dcmtk/dcmimgle/dibaslut.h"
#include "dcmtk/dcmimgle/diobjcou.h"
/*------------------------*
* forward declarations *
*------------------------*/
class DcmObject;
class DcmUnsignedShort;
class DcmLongString;
class DiDocument;
class DcmItem;
/*---------------------*
* class declaration *
*---------------------*/
/** Class to handle color palette look-up tables
*/
class DCMTK_DCMIMGLE_EXPORT DiLookupTable
: public DiBaseLUT,
public DiObjectCounter
{
public:
/** constructor
*
** @param docu pointer to dataset (encapsulated)
* @param descriptor tag key containing the LUT descriptor
* @param data tag key containing the LUT data
* @param explanation tag key containing the LUT explanation
* @param descripMode mode specifying the use of the bits per table entry value
* @param status pointer to image status variable (optional)
*/
DiLookupTable(const DiDocument *docu,
const DcmTagKey &descriptor,
const DcmTagKey &data,
const DcmTagKey &explanation,
const EL_BitsPerTableEntry descripMode = ELM_UseValue,
EI_Status *status = NULL);
/** constructor
*
** @param docu pointer to dataset (encapsulated)
* @param sequence tag key containing the LUT sequence
* @param descriptor tag key containing the LUT descriptor
* @param data tag key containing the LUT data
* @param explanation tag key containing the LUT explanation
* @param descripMode mode specifying the use of the bits per table entry value
* @param pos position in the LUT sequence which should be used (optional)
* @param card pointer to storage area where the number of sequence entries
* should be stored (optional)
*/
DiLookupTable(const DiDocument *docu,
const DcmTagKey &sequence,
const DcmTagKey &descriptor,
const DcmTagKey &data,
const DcmTagKey &explanation,
const EL_BitsPerTableEntry descripMode = ELM_UseValue,
const unsigned long pos = 0,
unsigned long *card = NULL);
/** constructor
*
** @param data element containing the LUT data
* @param descriptor element containing the LUT descriptor
* @param explanation element containing the LUT explanation (optional)
* @param descripMode mode specifying the use of the bits per table entry value
* @param first expected value for "first input value mapped" (optional)
* @param status pointer to image status variable (optional)
*/
DiLookupTable(const DcmUnsignedShort &data,
const DcmUnsignedShort &descriptor,
const DcmLongString *explanation = NULL,
const EL_BitsPerTableEntry descripMode = ELM_UseValue,
const signed long first = -1,
EI_Status *status = NULL);
/** constructor
*
** @param buffer pointer to array with LUT entries
* @param count number of LUT entries
* @param bits number of bits per entry
*/
DiLookupTable(Uint16 *buffer,
const Uint32 count,
const Uint16 bits);
/** destructor
*/
virtual ~DiLookupTable();
/** invert all LUT values.
* (new_value = max_value - old_value, e.g. used for presentation LUTs)
*
** @param flag if bit 0 is set (0x1, default) the internal copy of the LUT data is modified
* or a copy of the original data is created (if not already existing),
* if bit 1 is set (0x2) the original LUT data is modified,
* a combination of both modes is also supported.
*
** @return status true if successful (0x1 if internal data modified, 0x2 if original data, 0x3 if both),
* false otherwise
*/
int invertTable(const int flag = 0x1);
/** mirror the order of all LUT entries.
* i.e. the last one becomes the first etc.
* (value[i] = value[last - i], e.g. used for presentation LUTs)
*
** @param flag if bit 0 is set (0x1, default) the internal copy of the LUT data is modified
* or a copy of the original data is created (if not already existing),
* if bit 1 is set (0x2) the original LUT data is modified,
* a combination of both modes is also supported.
*
** @return status true if successful (0x1 if internal data modified, 0x2 if original data, 0x3 if both),
* false otherwise
*/
int mirrorTable(const int flag = 0x1);
/** create an inverse copy of the current LUT.
* (input values become output values and vice versa)
* This function is used for DICOM print (mainly 8<->12 bit).
*
** @return pointer to inverse LUT
*/
DiLookupTable *createInverseLUT() const;
/** compares current LUT with specified LUT
*
** @param data element containing the LUT data
* @param descriptor element containing the LUT descriptor
*
** @return true if LUTs are not equal (1 = invalid LUT / memory error,
* 2 = descriptor differs,
* 3 = data differs)
* false (0) otherwise
*/
int compareLUT(const DcmUnsignedShort &data,
const DcmUnsignedShort &descriptor);
/** compares current LUT with specified LUT
*
** @param lut LUT to be compared with the current one
*
** @return OFTrue if LUTs are equal, OFFalse otherwise
*/
virtual OFBool operator==(const DiBaseLUT &lut);
/** compares current LUT with specified LUT
*
** @param lut LUT to be compared with the current one
*
** @return OFTrue if LUTs are equal, OFFalse otherwise
*/
virtual OFBool operator==(const DiLookupTable &lut);
protected:
/** initialize lookup table
*
** @param docu pointer to dataset (encapsulated)
* @param item pointer to item in dataset where to start (maybe NULL)
* @param descriptor tag key containing the LUT descriptor
* @param data tag key containing the LUT data
* @param explanation tag key containing the LUT explanation
* @param descripMode mode specifying the use of the bits per table entry value
* @param status pointer to image status variable (optional)
*/
void Init(const DiDocument *docu,
DcmItem *item,
const DcmTagKey &descriptor,
const DcmTagKey &data,
const DcmTagKey &explanation,
const EL_BitsPerTableEntry descripMode = ELM_UseValue,
EI_Status *status = NULL);
/** check (and possibly correct) lookup table for consistency
*
** @param count number of LUT entries
* @param bits bits per LUT entry
* @param descripMode mode specifying the use of the bits per table entry value
* @param status pointer to image status variable (optional)
*/
void checkTable(unsigned long count,
Uint16 bits,
const EL_BitsPerTableEntry descripMode = ELM_UseValue,
EI_Status *status = NULL);
/** check (and possibly correct) value for bits per LUT entry.
* Be very lenient with the value stored in the LUT descriptor and
* therefore perform some addition (heuristical tests) to assume the
* most probable value.
*
** @param bits actual value for bits per entry
* @param rightBits right value (8 or 16)
* @param wrongBits wrong value (8 or 16)
* @param descripMode mode specifying the use of the bits per table entry value
*/
void checkBits(const Uint16 bits,
const Uint16 rightBits,
const Uint16 wrongBits = 0,
const EL_BitsPerTableEntry descripMode = ELM_UseValue);
private:
/// number of bits originally allocated for a LUT entry
int OriginalBitsAllocated;
/// pointer to original data buffer (where the LUT data is created from)
void *OriginalData;
// --- declarations to avoid compiler warnings
DiLookupTable(const DiLookupTable &);
DiLookupTable &operator=(const DiLookupTable &);
};
#endif
|