Contents
Navigation
Home User Reference Other Resources


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
(other as QTPlgDicomImagePixel)
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:
  • "LIN"
  • "LOG"
  • "DISP"
(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

(byref minC as integer, byref maxC as integer, byref minW as integer, byref maxW as integer)
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
returns nothing. You can check the class property for errors
[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