The DICOM standard defines the Print Management Service Class to facilitate the printing of images and image related data. The functionality of L_DicomPrintSCUXXX simplifies the process of building a Print Management Service Class User (Print SCU).
The functionality of L_DicomPrintSCUXXX can be divided into the following categories:
Association
The Association with the Print Management Service Class Provider (Print SCP) can be simply established by calling the function L_DicomPrintSCUAssociate. The SOP/Meta SOP Classes supported by the Print SCU itself are specified when calling this function. The following functions are also related to Association handling:
L_DicomPrintSCUGetAssociateRejectInfo
L_DicomPrintSCUIsClassSupported
Basic Print Management
Having the Association established, the Basic Print Management can be started by requesting the Print SCP to create a Film Session. This is done using the function L_DicomPrintSCUCreateFilmSession. The following functions are related to Film Session handling:
L_DicomPrintSCUGetFilmSessionInstanceUID
L_DicomPrintSCUUpdateFilmSession
L_DicomPrintSCUPrintFilmSession
L_DicomPrintSCUDeleteFilmSession
L_DicomPrintSCUGetDefaultFilmSessionParameters
Once the Film Session is created, the Print SCP can be requested to create one or more Film Boxes. A Film Box can be created using the function L_DicomPrintSCUCreateFilmBox. The following functions are related to Film Box handling:
L_DicomPrintSCUGetFilmBoxInstanceUID
L_DicomPrintSCUGetDefaultFilmBoxParameters
When the Print SCP is requested to create a Film Box, it will also create one or more Image Boxes. The function L_DicomPrintSCUGetImageBoxesCount returns the count of these Image Boxes, which can be handled using the following functions:
L_DicomPrintSCUGetImageBoxInstanceUID
L_DicomPrintSCUGetDefaultImageBoxParameters
L_DicomPrintSCUFreeImageBoxesInstanceUIDs
Similarly, when the Print SCP is requested to create a Film Box, it might also create one or more Annotation Boxes. The function L_DicomPrintSCUGetAnnotationBoxesCount returns the count of these Annotation Boxes, which can be handled using the following functions:
L_DicomPrintSCUGetAnnotationBoxInstanceUID
L_DicomPrintSCUUpdateAnnotationBox
L_DicomPrintSCUFreeAnnotationBoxesInstanceUIDs
If the Presentation LUT SOP Class is supported on the Association, the Print SCP can be requested to create a Presentation LUT. Once a Presentation LUT is created, it can be referenced by the Film Boxes and Grayscale Image Boxes. The following functions handle Presentation LUTs:
L_DicomPrintSCUCreatePresentationLUT
L_DicomPrintSCUGetPresentationLUTInstanceUID
L_DicomPrintSCUDeletePresentationLUT
If the Basic Print Image Overlay Box SOP Class is supported on the Association, the Print SCP can be requested to create an Image Overlay Box, which can then be referenced by the Image Boxes. The following functions handle Image Overlay Boxes:
L_DicomPrintSCUCreateOverlayBox
L_DicomPrintSCUGetOverlayBoxInstanceUID
L_DicomPrintSCUUpdateOverlayBox
L_DicomPrintSCUDeleteOverlayBox
L_DicomPrintSCUGetDefaultOverlayBoxParameters
Pull Stored Print Management
Having the Association established, the Pull Stored Print Management can be started by using the function L_DicomPrintSCUCreatePullPrintRequest to request the Print SCP to create a Pull Print Request SOP Instance. The following functions handle Pull Stored Print Management sessions:
L_DicomPrintSCUGetPullPrintRequestInstanceUID
L_DicomPrintSCUPrintPullPrintRequestSession
L_DicomPrintSCUDeletePullPrintRequest
L_DicomPrintSCUGetDefaultPullPrintRequestParameters
Printer
The function L_DicomPrintSCUGetPrinterInfo can be used to query the Print SCP for information about the printer. Information that can be retrieved includes Printer Name, Printer Manufacturer, Printer Status, etc. The callback function PRINTSCUPRINTERREPORTCALLBACK will be called whenever a printer status report is received from the Print SCP.
The function L_DicomPrintSCUGetPrinterConfiguration can be used to query the Print SCP for the printer configuration information.
Print Jobs
When a printing request is sent to the Print SCP, and if the Print Job SOP Class is supported on the Association, the Print SCP will create a Print Job SOP Instance for the new Print Job. The SOP Instance UID of that Instance is returned by the function L_DicomPrintSCUGetPrintJobInstanceUID. This SOP Instance UID can then be passed to the function L_DicomPrintSCUGetPrintJobInfo to query the Print SCP for information about the Print Job. The callback function PRINTSCUPRINTJOBREPORT will be called whenever a Print Job status report is received from the Print SCP.
In addition to the functions mentioned above:
The callback function PRINTSCUSTATUSCALLBACK can be used to monitor the status of the Print SCU itself.
The function L_DicomPrintSCUGetLastOperationStatus returns the status code specified in the response of the Print SCP.
The function L_DicomPrintSCUSetTimeout sets the timeout value for communicating with the Print SCP.
The following sample illustrates the simplicity of using the L_DicomPrintSCUXXX functionality to print a single DICOM image:
L_VOID PrintImage(L_CHAR* pszImageFilename)
{
LDicomPrintSCU PrintSCU;
// Startup the network
LDicomNet::StartUp();
// Establish the Association
PrintSCU.Associate ("10.0.2.20", 7104, "PrintSCP", "PrintSCU",
PRINTSCU_BASIC_GRAYSCALE_PM_META_SOP_CLASS);
// Create the Film Session
PrintSCU.CreateFilmSession (NULL);
// Create the Film Box
FILMBOXPARAMETERS FBParams;
PrintSCU.GetDefaultFilmBoxParameters (&FBParams, sizeof(FILMBOXPARAMETERS));
PrintSCU.CreateFilmBox (&FBParams);
// Update the Image Box
IMAGEBOXPARAMETERS IBParams;
PrintSCU.GetDefaultImageBoxParameters (&IBParams, sizeof(IMAGEBOXPARAMETERS));
LDicomDS Image;
Image.LoadDS(pszImageFilename, DS_LOAD_CLOSE);
PrintSCU.UpdateImageBox (PrintSCU.GetImageBoxInstanceUID(0), &Image,
&IBParams);
// Print the Film Box
PrintSCU.PrintFilmBox ();
// Delete the Film Session
PrintSCU.DeleteFilmSession ();
// Release the Association
PrintSCU.Release ();
}