Mako 7.5.0 API
Loading...
Searching...
No Matches
JawsMako::IPCLXLInput Class Referenceabstract

An instance of the JawsMako PCL/XL input class. More...

#include <pclxlinput.h>

Inheritance diagram for JawsMako::IPCLXLInput:

Public Member Functions

virtual void setRopResolution (uint32 resolution)=0
 Set the resolution to be used when flattening ROPs.
 
virtual void setFlattenRops (bool flatten)=0
 Set whether or not ROPs should be flattened.
 
virtual void setDefaultPaperSize (const U8String &paperSize)=0
 Set the default paper size.
 
virtual void setDefaultLandscape (bool landscape)=0
 Set the default orientation.
 
virtual void setDefaultCopies (uint32 copies)=0
 Set the default number of per-page copies.
 
virtual void setDefaultDuplex (bool duplex)=0
 Set whether or not duplex should be set by default.
 
virtual void setDefaultDuplexBindingMode (IPJLParser::eDuplexBindingMode bindingMode)=0
 Set the default binding edge for duplexing.
 
virtual void setDefaultManualFeed (bool manualFeed)=0
 Set whether or not manual feed should be set by default.
 
virtual void setDefaultsFromPjl (IPJLParserPtr &pjlParser)=0
 Take initialisation data from the given PJL parser.
 
virtual void enableUnencapsulatedMode (bool unencapsulated)=0
 Enable or disable unencapsulated mode.
 
virtual void setMediaHandler (IMediaHandler *mediaHandler)=0
 Set the IMediaHandler instance to use to handle unsatisfied media requests.
 
virtual void setAttributeHandler (IPCLXLAttributeHandler *attributeHandler)=0
 Set the IPCLXLAttributeHandler instance to use to handle illegal PCL/XL operator attributes.
 
- Public Member Functions inherited from JawsMako::IInput
virtual IDocumentAssemblyPtr open (const U8String &pathToFile)=0
 Open a file on disk, returning the IDocumentAssembly representing the contents.
 
virtual IDocumentAssemblyPtr open (const String &pathToFile)=0
 Open a file on disk, returning the IDocumentAssembly representing the contents. Takes a wide character string.
 
virtual IDocumentAssemblyPtr open (const IInputStreamPtr &inputStream)=0
 Open a stream, returning the IDocumentAssembly representing the contents.
 
virtual void setSequentialMode (bool sequential)=0
 Set/unset sequential mode on this input.
 
virtual void setParameter (const U8String &param, const U8String &value)=0
 Apply a key value pair output parameter with a string value. The parameter name is case insensitive. Please refer to the supplied documentation for the details of the available parameters and their ranges.
 
- Public Member Functions inherited from IRCObject
virtual void addRef () const =0
 Increases the reference count of the actual object pointed to. This would take place during an assignment or copying.
 
virtual bool decRef () const =0
 Decreases the reference count of the actual object pointed to. When the reference count falls to Zero, it deletes the actual object pointed to.
 
virtual int32 getRefCount () const =0
 Retrieve the current reference count of the actual object pointed to.
 

Static Public Member Functions

static JAWSMAKO_API IPCLXLInputPtr create (const IJawsMakoPtr &jawsMako, const IProgressMonitorPtr &progressMonitor=IProgressMonitorPtr())
 Create an input for reading source documents in PCL/XL format.
 
- Static Public Member Functions inherited from JawsMako::IInput
static JAWSMAKO_API IInputPtr create (const IJawsMakoPtr &jawsMako, eFileFormat format, const IProgressMonitorPtr &progressMonitor=IProgressMonitorPtr())
 Create an input for reading source documents in the given format. The following formats are currently supported:
 

Additional Inherited Members

- Protected Member Functions inherited from IRCObject
virtual ~IRCObject ()
 Virtual destructor.
 

Detailed Description

An instance of the JawsMako PCL/XL input class.

Member Function Documentation

◆ create()

static JAWSMAKO_API IPCLXLInputPtr JawsMako::IPCLXLInput::create ( const IJawsMakoPtr & jawsMako,
const IProgressMonitorPtr & progressMonitor = IProgressMonitorPtr() )
static

Create an input for reading source documents in PCL/XL format.

Parameters
jawsMakoThe IJawsMako object
progressMonitorA smart pointer to an IProgressMonitor object which can be NULL if no such object was passed in.
Returns
IPCLXLInputPtr the PCL/XL input

◆ enableUnencapsulatedMode()

virtual void JawsMako::IPCLXLInput::enableUnencapsulatedMode ( bool unencapsulated)
pure virtual

Enable or disable unencapsulated mode.

      Setting this mode to true changes the parser behaviour
      as follows.

      - The input stream is not opened; it is assumed to point to
        the start of a PCL/XL session.
      - The PJL parser is not used. If PJL is encountered an
        error will be thrown.
      - The PCL/XL interpreter will not consume data after the point the
        PCL/XL interpreter either exhausts the stream or returns
        to PJL. After requesting a document after the last document
        in the session, or by requesting the number of documents) the
        stream will be positioned at the point that the PCL/XL
        interpreter exited.

        Note: The file pointer may move if the input stream is random
        access and earlier pages are re-requested. So, if using a
        random-access stream, care is required.

      Whereas the default (false) will:

      - open() the input stream.
      - use the built-in PJL parser when PJL is encountered.
      - process all PCL/XL sessions present in the stream, even
        if they are interupted by returning to PJL.

◆ setAttributeHandler()

virtual void JawsMako::IPCLXLInput::setAttributeHandler ( IPCLXLAttributeHandler * attributeHandler)
pure virtual

Set the IPCLXLAttributeHandler instance to use to handle illegal PCL/XL operator attributes.

Note that this routine does not take ownership of the passed pointer, which must remain allocated until after the input is complete.

◆ setDefaultCopies()

virtual void JawsMako::IPCLXLInput::setDefaultCopies ( uint32 copies)
pure virtual

Set the default number of per-page copies.

      The default is 1. Must be greater than zero.

◆ setDefaultDuplex()

virtual void JawsMako::IPCLXLInput::setDefaultDuplex ( bool duplex)
pure virtual

Set whether or not duplex should be set by default.

      The default is false.

◆ setDefaultDuplexBindingMode()

virtual void JawsMako::IPCLXLInput::setDefaultDuplexBindingMode ( IPJLParser::eDuplexBindingMode bindingMode)
pure virtual

Set the default binding edge for duplexing.

      The default is long edge.

◆ setDefaultLandscape()

virtual void JawsMako::IPCLXLInput::setDefaultLandscape ( bool landscape)
pure virtual

Set the default orientation.

      Pass true to set landscape, or false to set portrait.
      The default is portrait.

◆ setDefaultManualFeed()

virtual void JawsMako::IPCLXLInput::setDefaultManualFeed ( bool manualFeed)
pure virtual

Set whether or not manual feed should be set by default.

      The default is false.

◆ setDefaultPaperSize()

virtual void JawsMako::IPCLXLInput::setDefaultPaperSize ( const U8String & paperSize)
pure virtual

Set the default paper size.

      The paper size is set using a string. To take effect the paper
      size string must match one of the standard strings in the PCL/XL
      specification:

      - letter
      - legal
      - a4
      - exec
      - executive
      - ledger
      - a3
      - com10envelope
      - monarchenvelope
      - c5envelope
      - dlenvelope
      - b4
      - jb5
      - b5envelope
      - jpostcard
      - jdoublepostcard
      - jdoublepostcard
      - a5
      - a6
      - jb6

      The matching is case-insensitive.

      The default page size is a4

◆ setDefaultsFromPjl()

virtual void JawsMako::IPCLXLInput::setDefaultsFromPjl ( IPJLParserPtr & pjlParser)
pure virtual

Take initialisation data from the given PJL parser.

      Uses the environment in the given PJL parser to set
      defaults in the PCL/XL input. Any previously set
      defaults will be ignored.

      This is especially useful with unencapsulated mode,
      where PJL parsing happens externally to the input.

◆ setFlattenRops()

virtual void JawsMako::IPCLXLInput::setFlattenRops ( bool flatten)
pure virtual

Set whether or not ROPs should be flattened.

Please see setRopResolution() for information on ROPs.

      If false, the input will not flatten ROPs. As a result the DOM that
      is produced will not be visually correct. Instead, the ROP components
      will appear in the DOM as distinct objects grouped in a special
      IDOMGroup.

      This mode is useful if only information about the job is required.
      ROPs may be expensive especially for pathological cases which use
      large amounts of overdraw. If we merely need to know what text is on
      a page, the number of pages, whether the content is black and white or
      color etc, then flattening ROPs may significantly slow processing for
      no benefit. Setting this parameter false will avoid that processing.

      The default is true; ROPs will be flattened.

      If false, the ROPs will appear in the DOM inside groups with properties
      denoting their purpose. The operands for a ROP will be stored inside an
      IDOMGroup that is tagged with the property (see IDOMNode::getProperty())
      "RopGroup". Inside that group will be up to two nodes that represent the
      ROP operands. These will be tagged with the property "RopSource" for the
      source operand, and "RopPaint" for the paint operand. The value of these
      properties is irrelevant; only their presence is important.
Parameters
flattenTrue to flatten ROPs, false to avoid flattening ROPs.

◆ setMediaHandler()

virtual void JawsMako::IPCLXLInput::setMediaHandler ( IMediaHandler * mediaHandler)
pure virtual

Set the IMediaHandler instance to use to handle unsatisfied media requests.

Note that this routine does not take ownership of the passed pointer, which must remain allocated until after the input is complete.

◆ setRopResolution()

virtual void JawsMako::IPCLXLInput::setRopResolution ( uint32 resolution)
pure virtual

Set the resolution to be used when flattening ROPs.

      PCL/XL features a method of using bitwise operations to
      composite pixels from patterns and images with content
      already on the page. These are known as ROPs (Raster
      OPerations). These are not compatible with the DOM and
      most other PDLs, and in many situations require rendering
      at the input stage.

      This parameter controls the rendering resolution. The default
      is 600dpi.
Parameters
resolutionThe ROP rendering resolution to use.

The documentation for this class was generated from the following file: