DicomObjects Reference
DicomObjects Reference / DicomLabel Object
In This Topic
    DicomLabel Object
    In This Topic

    A DicomLabel item represents a label, or annotation, to be displayed over an image in a DicomViewer control, or in derived copies of the image.
    Labels may be ellipses (or circles), rectangles (or squares), lines, text or bitmaps, or other shapes (see LabelType for a full list), and the properties control not only the type and size of the object, but many other properties such as colour and line thickness. 

    Labels may be tied to the viewer control, to the display area in which an image is displayed, or to the image itself, this latter distinction being controlled by the RotateModeWithImage property.
    All properties have default values, which are suitable for many uses, and each is documented with the appropriate property.  The same label may be added into several DicomLabels collections if necessary, but where this is done, subsequent labels will be “cloned” when added, so that they may later be manipulated independently.  Also, unambiguous association of each DicomLabel with one image is necessary for the ROI functions.


    Many new methods and properties have been added in version 4.1, to support both the needs of developers, and also to provide full compatibility with DICOM annotations as used in the presentation state definition.  The main additions are:

    • Arc type labels
    • Interpolated Polygons
    • “Special” labels to handle automatic anatomic side markers

    An arc is defined as if it were an ellipse using top, left, height and width, but the first two items of the Points collection are used to define the start and end (working anti-clockwise)

    There is a separate help topic for Special Labels.

    See Also