DicomObjects.NET8 Documentation
DicomObjects Namespace / DicomAssociation Class / SetQuality Method

The transfer syntax to which this quality factor applies

The quality to be set




In This Topic
    SetQuality Method
    In This Topic
    Set the quality factor for lossy compression
    Syntax
    'Declaration
     
    
    Public Sub SetQuality( _
       ByVal TransferSyntax As String, _
       ByVal Quality As Object _
    ) 
    'Usage
     
    
    Dim instance As DicomAssociation
    Dim TransferSyntax As String
    Dim Quality As Object
     
    instance.SetQuality(TransferSyntax, Quality)
    public void SetQuality( 
       string TransferSyntax,
       object Quality
    )
    public:
    void SetQuality( 
       String^ TransferSyntax,
       Object^ Quality
    ) 

    Parameters

    TransferSyntax

    The transfer syntax to which this quality factor applies

    Quality

    The quality to be set

    Remarks

    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 .

    Requirements

    Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

    See Also