DicomObjects.NET.8.48 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 System.String, _
       ByVal Quality As System.Object _
    ) 
    'Usage
     
    
    Dim instance As DicomAssociation
    Dim TransferSyntax As System.String
    Dim Quality As System.Object
     
    instance.SetQuality(TransferSyntax, Quality)
    public void SetQuality( 
       System.string TransferSyntax,
       System.object Quality
    )
    public procedure SetQuality( 
        TransferSyntax: System.String;
        Quality: System.TObject
    ); 
    public function SetQuality( 
       TransferSyntax : System.String,
       Quality : System.Object
    );
    public: void SetQuality( 
       System.string* TransferSyntax,
       System.Object* Quality
    ) 
    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

    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: .NET CLR 4.8 or higher

    See Also