The QTPlgDicomImagePixel class defines data elements that convey informations useful to
describe the pixel data of an image. Such a informations are necessary when you need to support display of image data.
Many data elements are defined by the Dicom Standard to be enclosed into this group and
which of those elements are present into a given dicom file depends on the type of that file; some of them can be mandatory for
a SOP Class optional for another and so on. However, the standard data elements supported by the
QTPlgDicomImagePixel class should be enough in the most of the situations.
For every other element you eventually need, you can use the
generic key
()–value
() mechanism implemented by the
class.
Since version 6.3 of the plugin this class can be used in Console Applications
→
→
The
QTPlgDicomImagePixel class constructors are called when you create a new instance of the class, while
the
˜QTPlgDicomImagePixel class destructor, is called automatically when the
class is no more in use. Also, you can invoke the class destructor by setting the instance of the class to
nil.
Once a new class instance is returned, it is good practice to check the
class property to
be sure that the new object can be used. See the
validity requirements for more details.
The class provides you with the following initializer methods:
This is the default constructor. Use this constructor to create a new empty data set container in memory. Using this constructor
causes the following data elements to be added to the data set:
- =
"MONOCHROME2"
- =1
- =8
- =8
- =7
This is the copy constructor. The properties of the object to be copied will be used to initialize the
new class instance properties
specifies the intended interpretation of the pixel data. This property can be set with the following enumerated values only:
- "MONOCHROME1"
- "MONOCHROME2"
- "PALETTE COLOR"
- "RGB"
- "HSV"
- "YBR_FULL"
- "YBR_FULL_422"
- "YBR_PARTIAL_422"
- "YBR_PARTIAL_420"
- "YBR_ICT"
- "YBR_RCT"
- "ARGB"
- "CMYK"
specifies the output units of and
class properties
specifies the data representation of the pixel samples. Each sample shall have the same pixel representation.
If this property is set to true the pixel values are to be interpreted as 2’s complement values;
otherwise they are to be interpreted as unsigned integers
indicates whether the image characteristics allow to use the
and
class properties
specifies the number of samples (planes) in this image
indicates whether the pixel data are sent color–by–plane
(the property is set to 1) or color–by–pixel (the property is set to
0). Required if
has a value greater than
1
specifies the number of rows in the image
[Deprecated]: since version 6.3 of the plugin this property is deprecated
and will be removed from a future plugin version; use the
class property instead
specifies the number of columns in the image
[Deprecated]: since version 6.3 of the plugin this property is deprecated
and will be removed from a future plugin version; use the
class property instead
specifies the width (number of columns) and the height (number of rows) of the image
specifies the number of bits allocated for each pixel sample. Each sample shall have the same number of bits allocated
specifies the number of bits stored for each pixel sample. Each sample shall have the same number of bits stored
specifies the most significant bit for pixel sample data. Each sample shall have the same high bit
indicates the number of frames in a multi–frame image
specifies the frame number selected for use as a pictorial representation (e.g. icon) of the multi–frame image
(data element (0028,6010) of the Standard Dicom Dictionary)
specifies the relationship between the pixel sample values and the X–Ray beam intensity; currently you can use the
following enumerated values to set up this property:
(data element (
0028,
1040) of the
Standard Dicom Dictionary)
specifies the value
b in relationship between stored values (
SV) and the output units.
= m
* SV + b
specifies
m in the equation specified by
specifies the Data Element Tag of the attribute that is used as the frame increment in
multi–frame pixel data
specifies the values of the red, green, blue and, optionally, alpha lookup table data Data Elements along with their associated data descriptor Data Elements. Setting this property
is effective only if the has a value of "COLOR PALETTE" and the
value equals 1
specifies the window center for display
specifies the window width for display. Required if
is present
specifies the window center and window width for display. The
prpoperty represents the input value that is the center of the window. The
property represents the width of the window.
specifies a valid range applicable to the
value
given the actual pixel data characteristics
specifies a valid range applicable to the
value
given the actual pixel data characteristics
specifies image pixel data characteristics using an Image Description QuickTime structure
use this method to find about the valid range applicable to the
(returned in the
minC
and
maxC parameters) and
(returned in the
minW
and
maxW parameters) properties given the actual pixel data characteristics
[Deprecated]: since version 6.1.0 of the plugin this method is deprecated
and will be removed from a future plugin version; use the
and
and
class properties instead