DicomObjects.NET.V8
DicomObjects Namespace / DicomImage Class / PrinterImage Method / PrinterImage(Int32,Int32,Boolean,Matrix,Rectangle,Int32,Int32) Method

Bit depth of final image (must be 8-16, but always 8 when Planes=3)

1 for monochrome and 3 for colour

Controls whether annotations are "burnt-in" to the new image

The transform to apply to the pixels - this includes zoom etc.

The output area to be filled

The frame number to use. This is 1-index, i.e. first frame is 1 not 0

The planar configuration value of the resulting image. For use in Printing, this should be 1 as defined by DICOM rules, but if this function is used for other purposes, then 0 may be required.




In This Topic
    PrinterImage(Int32,Int32,Boolean,Matrix,Rectangle,Int32,Int32) Method
    In This Topic
    Creates a copy of the image for printing or other purposes
    Syntax
    'Declaration
     
    Public Overloads Function PrinterImage( _
       ByVal Bits As Integer, _
       ByVal Planes As Integer, _
       ByVal ShowAnnotations As Boolean, _
       ByVal Matrix As Matrix, _
       ByVal FinalArea As Rectangle, _
       ByVal Frame As Integer, _
       ByVal PlanarConfig As Integer _
    ) As DicomImage
    'Usage
     
    Dim instance As DicomImage
    Dim Bits As Integer
    Dim Planes As Integer
    Dim ShowAnnotations As Boolean
    Dim Matrix As Matrix
    Dim FinalArea As Rectangle
    Dim Frame As Integer
    Dim PlanarConfig As Integer
    Dim value As DicomImage
     
    value = instance.PrinterImage(Bits, Planes, ShowAnnotations, Matrix, FinalArea, Frame, PlanarConfig)
    public DicomImage PrinterImage( 
       int Bits,
       int Planes,
       bool ShowAnnotations,
       Matrix Matrix,
       Rectangle FinalArea,
       int Frame,
       int PlanarConfig
    )
    public:
    DicomImage^ PrinterImage( 
       int Bits,
       int Planes,
       bool ShowAnnotations,
       Matrix^ Matrix,
       Rectangle FinalArea,
       int Frame,
       int PlanarConfig
    ) 

    Parameters

    Bits

    Bit depth of final image (must be 8-16, but always 8 when Planes=3)

    Planes

    1 for monochrome and 3 for colour

    ShowAnnotations

    Controls whether annotations are "burnt-in" to the new image

    Matrix

    The transform to apply to the pixels - this includes zoom etc.

    FinalArea

    The output area to be filled

    Frame

    The frame number to use. This is 1-index, i.e. first frame is 1 not 0

    PlanarConfig

    The planar configuration value of the resulting image. For use in Printing, this should be 1 as defined by DICOM rules, but if this function is used for other purposes, then 0 may be required.

    Return Value

    Remarks
    The copy is fully rendered and scaled to the chosen bit depth, so no further windowing is required. Only 8 bits are allowed when Planes=3 (RGB). Area refers to the original image � the size of the final image is the product of the cropped size and the chosen zoom. If the edges are given as 0, the full image is used.
    Requirements

    Target Platforms: .NET CLR 4.0 or higher

    See Also