''' <summary>
''' Updates the visibility of patien orientation metadata.
''' </summary>
''' <param name="dicomViewerTool">The DICOM viewer tool.</param>
''' <param name="isMetadataVisible">Determines that the metadata is visible.</param>
Public Shared Sub SetPatientOrientationMetadataVisibility(dicomViewerTool As Vintasoft.Imaging.Dicom.UI.VisualTools.DicomViewerTool, isMetadataVisible As Boolean)
    ' for each text overlay, which is displayed using the DICOM viewer tool
    For Each textOverlay As Vintasoft.Imaging.UI.VisualTools.TextOverlay In dicomViewerTool.TextOverlay
        ' if text overlay display information about patien orientation
        If TypeOf textOverlay Is Vintasoft.Imaging.Dicom.UI.VisualTools.PatientOrientationTextOverlay Then
            ' change the text overlay visibility
            textOverlay.IsVisible = isMetadataVisible
        End If
    Next
End Sub

''' <summary>
''' Updates the visibility of VOI LUT metadata.
''' </summary>
''' <param name="dicomViewerTool">The DICOM viewer tool.</param>
''' <param name="isMetadataVisible">Determines that the metadata is visible.</param>
Public Shared Sub SetDicomImageVoiLutVisibility(dicomViewerTool As Vintasoft.Imaging.Dicom.UI.VisualTools.DicomViewerTool, isMetadataVisible As Boolean)
    ' for each text overlay, which is displayed using the DICOM viewer tool
    For Each textOverlay As Vintasoft.Imaging.UI.VisualTools.TextOverlay In dicomViewerTool.TextOverlay
        ' if text overlay display information about VOI LUT
        If TypeOf textOverlay Is Vintasoft.Imaging.Dicom.UI.VisualTools.DicomImageVoiLutTextOverlay Then
            ' change the text overlay visibility
            textOverlay.IsVisible = isMetadataVisible
        End If
    Next
End Sub

''' <summary>
''' Updates the VOI LUT metadata format.
''' </summary>
''' <param name="dicomViewerTool">The DICOM viewer tool.</param>
''' <param name="voiLutMetadataFormat">The VOI LUT metadata format.</param>
Public Shared Sub SetVoiLutTextFormat(dicomViewerTool As Vintasoft.Imaging.Dicom.UI.VisualTools.DicomViewerTool, voiLutMetadataFormat As String)
    If String.IsNullOrEmpty(voiLutMetadataFormat) Then
        Throw New System.ArgumentNullException()
    End If

    ' set the format for VOI LUT metadata
    Vintasoft.Imaging.ImagingEnvironment.ResourceManager.SetString("DICOMIMAGEVOILUTOVERLAY_VOI_LUT_VALUE_FORMAT_{0}{1}", voiLutMetadataFormat, True)

    ' for each text overlay, which is displayed using the DICOM viewer tool
    For Each textOverlay As Vintasoft.Imaging.UI.VisualTools.TextOverlay In dicomViewerTool.TextOverlay
        ' if text overlay display information about VOI LUT
        If TypeOf textOverlay Is Vintasoft.Imaging.Dicom.UI.VisualTools.DicomImageVoiLutTextOverlay Then
            ' update text of text overlay
            DirectCast(textOverlay, Vintasoft.Imaging.Dicom.UI.VisualTools.DicomImageVoiLutTextOverlay).UpdateText()
        End If
    Next
End Sub

/// <summary>
/// Updates the visibility of patien orientation metadata.
/// </summary>
/// <param name="dicomViewerTool">The DICOM viewer tool.</param>
/// <param name="isMetadataVisible">Determines that the metadata is visible.</param>
public static void SetPatientOrientationMetadataVisibility(
    Vintasoft.Imaging.Dicom.UI.VisualTools.DicomViewerTool dicomViewerTool,
    bool isMetadataVisible)
{
    // for each text overlay, which is displayed using the DICOM viewer tool
    foreach (Vintasoft.Imaging.UI.VisualTools.TextOverlay textOverlay in dicomViewerTool.TextOverlay)
    {
        // if text overlay display information about patien orientation
        if (textOverlay is Vintasoft.Imaging.Dicom.UI.VisualTools.PatientOrientationTextOverlay)
            // change the text overlay visibility
            textOverlay.IsVisible = isMetadataVisible;
    }
}

/// <summary>
/// Updates the visibility of VOI LUT metadata.
/// </summary>
/// <param name="dicomViewerTool">The DICOM viewer tool.</param>
/// <param name="isMetadataVisible">Determines that the metadata is visible.</param>
public static void SetDicomImageVoiLutVisibility(
    Vintasoft.Imaging.Dicom.UI.VisualTools.DicomViewerTool dicomViewerTool,
    bool isMetadataVisible)
{
    // for each text overlay, which is displayed using the DICOM viewer tool
    foreach (Vintasoft.Imaging.UI.VisualTools.TextOverlay textOverlay in dicomViewerTool.TextOverlay)
    {
        // if text overlay display information about VOI LUT
        if (textOverlay is Vintasoft.Imaging.Dicom.UI.VisualTools.DicomImageVoiLutTextOverlay)
            // change the text overlay visibility
            textOverlay.IsVisible = isMetadataVisible;
    }
}

/// <summary>
/// Updates the VOI LUT metadata format.
/// </summary>
/// <param name="dicomViewerTool">The DICOM viewer tool.</param>
/// <param name="voiLutMetadataFormat">The VOI LUT metadata format.</param>
public static void SetVoiLutTextFormat(
    Vintasoft.Imaging.Dicom.UI.VisualTools.DicomViewerTool dicomViewerTool,
    string voiLutMetadataFormat)
{
    if (string.IsNullOrEmpty(voiLutMetadataFormat))
        throw new System.ArgumentNullException();

    // set the format for VOI LUT metadata
    Vintasoft.Imaging.ImagingEnvironment.ResourceManager.SetString(
        "DICOMIMAGEVOILUTOVERLAY_VOI_LUT_VALUE_FORMAT_{0}{1}",
        voiLutMetadataFormat,
        true);

    // for each text overlay, which is displayed using the DICOM viewer tool
    foreach (Vintasoft.Imaging.UI.VisualTools.TextOverlay textOverlay in dicomViewerTool.TextOverlay)
    {
        // if text overlay display information about VOI LUT
        if (textOverlay is Vintasoft.Imaging.Dicom.UI.VisualTools.DicomImageVoiLutTextOverlay)
            // update text of text overlay
            ((Vintasoft.Imaging.Dicom.UI.VisualTools.DicomImageVoiLutTextOverlay)textOverlay).UpdateText();
    }
}