JawsMako::IApexRenderer Class Reference

A renderer that uses the GPU-accelerated Apex RIP to create images from arbitrary DOM. More...

#include <apexrenderer.h>

Inheritance diagram for JawsMako::IApexRenderer:

Classes
class	CGpuDeviceInfo
	A class representing a GPU device discovered on the current host. More...

Public Member Functions
virtual void	render (const IDOMNodePtr &node, CRenderSpec *renderSpec)=0
	Render a node, targeting the given render specification. Any gray, RGB (except sRGB), or CMYK space is currently supported.
virtual void	setIgnoreMatchingDeviceIntercept (bool ignoreDeviceIntercept)=0
	Allow intercept color spaces for a matching Device space to be ignored.
virtual void	setBlackPreservation (bool preserveForText, bool preserveForOther)=0
	Enable/control 100% black preservation.
virtual void	setUse16BitInternalRendering (bool use16Bit)=0
	Specify whether or not to use 16 bit internal rendering.
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 IApexRendererPtr	create (const IJawsMakoPtr &jawsMako, int32 deviceIndex=-1)
	Create an Apex renderer instance.
static JAWSMAKO_API CGpuDeviceInfoVect	enumerateGpus ()
	Enumerate all the available GPU devices.

Additional Inherited Members
Protected Member Functions inherited from IRCObject
virtual	~IRCObject ()
	Virtual destructor.

Detailed Description

A renderer that uses the GPU-accelerated Apex RIP to create images from arbitrary DOM.

Member Function Documentation

create()

static JAWSMAKO_API IApexRendererPtr JawsMako::IApexRenderer::create ( const IJawsMakoPtr & jawsMako, int32 deviceIndex = -1 )

static

Create an Apex renderer instance.

Parameters

jawsMako	The Mako instance.
deviceIndex	The index of the device to use, or -1 for automatic. Device indexes may be discovered with enumerateGpus below; the index passed here is the index within the resulting enumerated GPUs.

Returns

IApexRendererPtr The new renderer instance.

enumerateGpus()

static JAWSMAKO_API CGpuDeviceInfoVect JawsMako::IApexRenderer::enumerateGpus ( )

static

Enumerate all the available GPU devices.

Returns

CGpuDeviceInfoVect A vector of all the available GPU devices.

render()

virtual void JawsMako::IApexRenderer::render ( const IDOMNodePtr & node, CRenderSpec * renderSpec )

pure virtual

Render a node, targeting the given render specification. Any gray, RGB (except sRGB), or CMYK space is currently supported.

Parameters

node	The node to render.
renderSpec	A pointer to the concrete render specification to target. CImageRenderSpec, CImagesRenderSpec, CFrameBufferRenderSpec, and CFrameBuffersRenderSpec are supported.

setBlackPreservation()

virtual void JawsMako::IApexRenderer::setBlackPreservation ( bool preserveForText, bool preserveForOther )

pure virtual

Enable/control 100% black preservation.

      100% black preservation preserves a 100% black output when rendering
      when enabled for certain solid colors.

      A 100% black object is an object painted with one of the following
      colors:

      - 0 0 0 1 in any CMYK color space (including ICC)
      - 0 0 0 in any RGB color space (including ICC)
      - 0 in any Gray colorspace (including ICC)
      - 1 in a single channel DeviceN (aka Separation) Black color space
      - 1 in a multi-channel DeviceN colorspace where only the Black channel
        is set.

      If black preservation applies then the resulting color will be either
      (depending on the target color space):

      - c m y 1 in any CMYK colorspace (including ICC)
      - 0 0 0 in any RGB colorspace (including ICC)
      - 0 in any Gray colorspace (including ICC)

      Note that the CMY values in a CMYK result may not be zero if color
      managed white conversion would not produce pure white.

      Note also that where transparency is involved this conversion only
      applies when converting to the blending colorspace, and has no
      further effect for further conversions.

      May be enabled separately for text and vector art. Applies to only
      solid color brushes (IDOMSolidColorBrush) and uncolored tiling
      patterns only.

      The default is set by #IColorManager::setDefaultBlackPreservation(),
      which defaults to false, false. The default is applied at the time
      of renderer creation.

Parameters

preserveForText	Whether or not to apply black preservation for text.
preserveForOther	Whether or not to apply for non-text objects.

setIgnoreMatchingDeviceIntercept()

virtual void JawsMako::IApexRenderer::setIgnoreMatchingDeviceIntercept ( bool ignoreDeviceIntercept )

pure virtual

Allow intercept color spaces for a matching Device space to be ignored.

      In the renderer, when a Device color space (DeviceRGB, DeviceCMYK, or
      DeviceGray) is seen, it is interpreted according to the intercept
      color space set in the IColorManager instance via the setDevice*Intercept()
      routines.

      This may not always be desirable. Consider the case where a CMYK ICC profile
      is used as the the process color space for rendering. If the DeviceCMYK
      intercept does not match that profile, then any DeviceCMYK content would be
      color converted from the intercept color space to the output profile.

      This behaviour is contrary to what would ordinarily be seen in a standalone
      RIP. There, it is expected that if the output is a CMYK profile, then any
      DeviceCMYK content would be passed through without conversion.

      The same result can be achieved in Mako by using
      IColorManager::setDeviceCMYKIntercept() to apply the output ICC profile as
      the DeviceCMYK intercept. However, this is a global setting, and it may not
      always be possible to do so.

      Here, if ignoreDeviceIntercept is set, then the renderer will do the following:

      - If the output process color space is a CMYK color space, then any DeviceCMYK
        content will be interpreted as matching that space.
      - If the output process color space is an RGB color space, then any DeviceRGB
        content will be interpreted as matching that space.

      The default is false.

setUse16BitInternalRendering()

virtual void JawsMako::IApexRenderer::setUse16BitInternalRendering ( bool use16Bit )

pure virtual

Specify whether or not to use 16 bit internal rendering.

      If true, Apex will use 16 bit buffers for all intermediate rendering,
      even if the final output depth is 8 bits per sample. This can be
      especially useful if there are many colour conversion steps or a
      significant amount of overdrawing transparency compositing required.

      This has no effect for 16 bit rendering.

      The default is false.

---

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

• apexrenderer.h