SetQuality Method

Visual Basic
C#

'Declaration
 
Public Sub SetQuality( _
   ByVal TransferSyntax As System.String, _
   ByVal Quality As System.Object _
)

public void SetQuality( 
   System.string TransferSyntax,
   System.object Quality
)

Parameters

TransferSyntax: The transfer syntax to which this quality factor applies
Quality: The quality to be set

An application does not necessarily "know" which images will be sent by which transfer syntax, as the remote AE may have accepted different transfer syntaxes for different abstract syntaxes, and a common quality factor for an association would not therefore be appropriate. Instead, this method allows quality to be set for a specific transfer syntax.

The following limitations apply:

This method is only meaningful when used in an application actually sending an image (normally the SCP), as there is no official means in DICOM for the SCU to send this information to the SCP.
Where an image is already compressed using the transfer syntax required, it is not decompressed and recompressed, so this value is ignored. If absolutely necessary, this can be over-ridden by applying the DecompressAll method to the image before sending it, but multiple compressions do have an adverse effect on image quality.

At present, the only syntaxes to which this method applies are TransferSyntaxes.JPEGBaseline (1.2.840.10008.1.2.4.50), TransferSyntaxes.JPEGExtended (1.2.840.10008.1.2.4.51), TransferSyntaxes.JPEG2000Lossy (1.2.840.10008.1.2.4.90), and TransferSyntaxes.JPEG2000Lossy (1.2.840.10008.1.2.4.91), though it is also made available to private syntaxes defined through .

C#

DicomDataSet image = new DicomDataSet("image.dcm");
 
string node = "dicomserver.co.uk";
int port = 104;
string callingAE = "SCU";
string calledAE = "SCP";
                    
using (DicomAssociation cn = new DicomAssociation())
{
    cn.RequestedContexts.Add(image.SOPClass, TransferSyntaxes.ExplicitVRLittleEndian);
    cn.Open(node, port, callingAE, calledAE);
    cn.SetQuality(TransferSyntaxes.JPEG2000Lossy, quality);
    cn.SendInstances(image);
    
    var result = cn.LastStatus;
    
    cn.Close();
}

Target Platforms: .NET CLR 4.8 or higher

Reference

DicomAssociation Class
DicomAssociation Members

Send Feedback