Programming with Reference Lines and Scout Lines In The Medical Viewer

The reference line is a feature that allows the user to determine the intersection point between two intersecting images in a 3-dimensional space. The reference line is represented in the MedicalViewer by a colored line striking through the image cell.

Information required for a reference line

You need to provide all of the information below in order to view an accurate reference line:

FrameOfReferenceUID: This information is needed by the MedicalViewer to connect the related images together. The images with the same Frame of Reference UID will have a reference line to each other. This information can be retrieved from the DicomDataSet.
PixelSpacing: This information is used to identify the measurement of each image in order to view a more accurate reference line. This information can be retrieved from the DicomDataSet.
ImagePosition: You must set the image position of each frame using the ImagePosition property. This information can be retrieved from the DicomDataSet.
ImageOrientation: This represents the image orientation in a 3-dimensional space. This information can be retrieved from the DicomDataSet.

Once all information is set, the user can view the reference line by using the MedicalViewerCell.ReferenceLine.Enabled property.

Change the color of the reference line for improved display using the MedicalViewerCell.ReferenceLine.Color property.

Trouble-Shooting

If you cannot view the reference line for two images, the reason could be one of the following:

You didn't provide the required information mentioned above, or you didn't set the properties correctly.
You didn't set the image position for each frame. The position must be set for all frames.
You didn't enable the reference line using the MedicalViewerCell.ReferenceLine.Enabled property.
You didn't add the cells to the MedicalViewer.
You provided a different FrameOfReferenceUID for each frame.
The images simply do not intersect with each other.
The images intersect at a distant point, which is not in the viewable area. In order to see the line, you must scale down or move the image.