diff options
| author | Barry Golden <[email protected]> | 2019-03-12 14:02:43 -0700 |
|---|---|---|
| committer | Adonais Romero González <[email protected]> | 2019-03-12 14:02:43 -0700 |
| commit | ef7ec4ec9ff7ce3c53d60e1c8906915966e17e01 (patch) | |
| tree | 3017523a73c6552c27947d402afa6062f4df2706 /print/XpsRasFilter | |
| parent | 35bff356ac249057f4d673d39c7f28ed348cbf0f (diff) | |
Update README.md for samples portal (#358)
* Update README.md for samples portal
* Update README.md for samples portal
* Removed installwdf
* Update fork (#2)
* Fix typo
ture -> true
* Remove InstallWdf sample
* Fix typo (#340)
ture -> true
* Readme typo fix (#349)
* Update langid
Diffstat (limited to 'print/XpsRasFilter')
| -rw-r--r-- | print/XpsRasFilter/README.md | 38 | ||||
| -rw-r--r-- | print/XpsRasFilter/print-xpsrasfilter.yml | 12 |
2 files changed, 22 insertions, 28 deletions
diff --git a/print/XpsRasFilter/README.md b/print/XpsRasFilter/README.md index 344c6bf9..af8342a1 100644 --- a/print/XpsRasFilter/README.md +++ b/print/XpsRasFilter/README.md @@ -1,3 +1,13 @@ +--- +topic: sample +name: XPS Rasterization Filter Service Sample +description: Implements an XPSDrv filter that rasterizes fixed pages in an XPS document. +languages: + - cpp +products: + - windows +--- + <!--- name: XPS Rasterization Filter Service Sample platform: DLL @@ -7,31 +17,27 @@ samplefwlink: http://go.microsoft.com/fwlink/p/?LinkId=617951 ---> - - -XPS Rasterization Filter Service Sample -======================================= +# XPS Rasterization Filter Service Sample This sample implements an XPSDrv filter that rasterizes fixed pages in an XPS document. Hardware vendors can modify this sample to build an XPSDrv filter that produces bitmap images for their printers or other display devices. The sample uses the XPS Rasterization Service that creates rasterizer objects for use by XPSDrv filters. A rasterizer object takes an XPS Object Model (XPS OM) page object and creates a bitmap of a specified region of the page. The sample implements an XPSDrv filter (xpsrasfilter.dll) that can be inserted into the XPS Filter Pipeline. For each fixed page in an XPS document, the sample filter does the following: -- Uses the XPS rasterization service to create a rasterizer object for the fixed page. -- Partitions the fixed page into several horizontal bands. -- Uses the rasterizer object to render each horizontal band as a bitmap image. +- Uses the XPS rasterization service to create a rasterizer object for the fixed page. +- Partitions the fixed page into several horizontal bands. +- Uses the rasterizer object to render each horizontal band as a bitmap image. -The Print Filter Pipeline is part of the XPS Print Path [Windows Print Path Overview](print.windows_print_path_overview). Fixed pages are sent as an XPS data stream from the XPS Spooler to the print filter pipeline. The print filter pipeline manager takes the XPS fixed page, calls each filter in the order defined in the pipeline configuration file, and then sends either Fixed Page OM objects or a data stream to each filter as required. The filters process the data and return either Fixed Page OM objects or a data stream back to the print filter pipeline manager. (See MSDN entry for Filter Pipeline Interfaces items IXpsDocumentProvider, IXpsDocumentConsumer, IPrintWriteStream, and IPrintReadStream.) +The Print Filter Pipeline is part of the XPS Print Path [Windows Print Path Overview](https://docs.microsoft.com/windows-hardware/drivers/print/windows-print-path-overview). Fixed pages are sent as an XPS data stream from the XPS Spooler to the print filter pipeline. The print filter pipeline manager takes the XPS fixed page, calls each filter in the order defined in the pipeline configuration file, and then sends either Fixed Page OM objects or a data stream to each filter as required. The filters process the data and return either Fixed Page OM objects or a data stream back to the print filter pipeline manager. (See MSDN entry for Filter Pipeline Interfaces items IXpsDocumentProvider, IXpsDocumentConsumer, IPrintWriteStream, and IPrintReadStream.) As a print filter pipeline service, the XPS Rasterization Service can be loaded into the filter pipeline when the pipeline is initialized by adding a filter service provider tag to the configuration XML file (for example, \<FilterServiceProvider dll="XpsRasterService.dll"/\>). The service is then available to be called by the filters when they are initialized and called by the print filter pipeline manager. The XPS Rasterization Service operates as follows: -- The calling filter initializes an instance of the rasterizer by passing in the XPS OM for the fixed page. -- The calling filter calls the RasterizeRect method of the rasterizer to render a specified rectangle area of the fixed page. -- RasterizeRect writes the WIC (Windows Imaging Component) bitmap data to memory. (The address is specified as a parameter to RasterizeRect.) +- The calling filter initializes an instance of the rasterizer by passing in the XPS OM for the fixed page. +- The calling filter calls the RasterizeRect method of the rasterizer to render a specified rectangle area of the fixed page. +- RasterizeRect writes the WIC (Windows Imaging Component) bitmap data to memory. (The address is specified as a parameter to RasterizeRect.) The default parameters in this sample are as follows: -- Letter-sized physical page (can override in print ticket). -- 0.25-inch margins (creating an 8-inch by 10.5-inch imageable area). -- Scaling is set to FitApplicationBleedSizeToImageableSize. -- Destination resolution set to 96 dpi (can override in print ticket). - +- Letter-sized physical page (can override in print ticket). +- 0.25-inch margins (creating an 8-inch by 10.5-inch imageable area). +- Scaling is set to FitApplicationBleedSizeToImageableSize. +- Destination resolution set to 96 dpi (can override in print ticket). diff --git a/print/XpsRasFilter/print-xpsrasfilter.yml b/print/XpsRasFilter/print-xpsrasfilter.yml deleted file mode 100644 index 17ca1420..00000000 --- a/print/XpsRasFilter/print-xpsrasfilter.yml +++ /dev/null @@ -1,12 +0,0 @@ -### YamlMime:Sample -sample: -- name: XPS Rasterization Filter Service Sample - description: Implements an XPSDrv filter that rasterizes fixed pages in an XPS document. - generateZip: true - preserveParentHierarchy: true - author: windows-driver-samples - languages: - - cpp - technologies: - - windows - vssolution: /print/XpsRasFilter/XpsRasFilter.sln |
