 |
Mako 8.3.0 API
MakoCore SDK API Documentation
|
|
Mako 8.3.0 API
MakoCore SDK API Documentation
|
A base class that describes base rendering properties common to all rendering operations. Not intended to be used directly. Instead, use instances of one of the subclasses that matches the rendering need. More...
#include <jawsmako/renderspec.h>
Public Types | |
| enum | eBlackPreservation { eBPDefault = 0 , eBPOn = 1 , eBPOff = 2 } |
| The possible types for enabling/controlling 100% black preservation. More... | |
Public Member Functions | |
| CRenderSpec () | |
| virtual | ~CRenderSpec ()=default |
| void | assignCommon (const CRenderSpec &other) |
Public Attributes | |
| IDOMColorSpacePtr | processSpace |
| uint32 | width |
| The width, in pixels, of the result. | |
| uint32 | height |
| The height, in pixels, of the result. | |
| uint8 | depth |
| The depth, in bits (8 or 16), of the result. | |
| FRect | sourceRect |
| The source area of the DOM that will be mapped to the output width and height. | |
| uint8 | aaFactor |
| The aaFactor to be used. 1 means no anti-aliasing. The maximum value is 4. | |
| bool | alpha |
| Whether or not alpha information should be produced. | |
| CSpotColorNames | retainedSpotColors |
| Spot components to generate as distinct separations/channels. | |
| CSpotColorNames | ignoredSpotColors |
| Spot components to ignore. | |
| CSpotColorAliasVect | aliasedSpotColors |
| Spot colorant aliases. Please see CSpotColorAlias for further information. | |
| bool | decomposeDeviceN |
| IDOMColorSpaceDeviceN::CColorantInfoVect | replacementSpotColors |
| CRenderPostProcessVect | postProcesses |
| IOptionalContentPtr | optionalContent |
| The optional content object for the document. | |
| eOptionalContentEvent | optionalContentEvent |
| eRenderingIntent | rgbImageRenderingIntent |
| eRenderingIntent | cmykImageRenderingIntent |
| bool | ignoreInputIccProfiles |
| CColorManagerConfigPtr | overrideCmmConfig |
| An optional CMM configuration override to apply to the given render. | |
| bool | use16BitInternalRendering |
| eBlackPreservation | preserveBlackForText |
| Whether or not to apply black preservation for text. | |
| eBlackPreservation | preserveBlackForOther |
| Whether or not to apply black preservation for non-text objects. | |
A base class that describes base rendering properties common to all rendering operations. Not intended to be used directly. Instead, use instances of one of the subclasses that matches the rendering need.
The possible types for enabling/controlling 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:
If black preservation applies then the resulting color will be either (depending on the target color space):
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 color space, 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.
| Enumerator | ||
|---|---|---|
| eBPDefault | 0 | Default behavior. |
| eBPOn | 1 | Use black point compensation if applicable during color conversion. |
| eBPOff | 2 | Do not use black point compensation during color conversion. |
|
inline |
|
virtualdefault |
|
inline |
| uint8 JawsMako::CRenderSpec::aaFactor |
The aaFactor to be used. 1 means no anti-aliasing. The maximum value is 4.
| CSpotColorAliasVect JawsMako::CRenderSpec::aliasedSpotColors |
Spot colorant aliases. Please see CSpotColorAlias for further information.
| bool JawsMako::CRenderSpec::alpha |
Whether or not alpha information should be produced.
| eRenderingIntent JawsMako::CRenderSpec::cmykImageRenderingIntent |
The rendering intent to be used for cmyk images. If eRenderingIntentUnset, the DOM intent will be used.
| bool JawsMako::CRenderSpec::decomposeDeviceN |
Whether or not to decompose DeviceN color spaces. Setting this to false keeps normal PDF-style DeviceN handling, whereby if a situation does not support all the colorants in a DeviceN color space, then the tint transform is used to convert the color to process. However, if set to true, the renderer will instead attempt to decompose incoming DeviceN color spaces into separate Process and Spot components. In this mode, the process components are color managed as process components, and the spot components are managed separately. If a spot component is available then it will be rendered separately as normal. If a spot component is not available, then it will be merged with the process components once the process components are managed, with the color for that spot component being taken from replacementSpotColors or, failing that, from DeviceN properties if present. Note that this feature gives up if the color of a spot component could not be determined via either of the above two methods.
| uint8 JawsMako::CRenderSpec::depth |
The depth, in bits (8 or 16), of the result.
| uint32 JawsMako::CRenderSpec::height |
The height, in pixels, of the result.
| CSpotColorNames JawsMako::CRenderSpec::ignoredSpotColors |
Spot components to ignore.
| bool JawsMako::CRenderSpec::ignoreInputIccProfiles |
If true, Gray, RGB and CMYK ICC profiles in the DOM will be ignored and instead be mapped to DeviceGray, DeviceRGB or DeviceCMYK as appropriate.
| IOptionalContentPtr JawsMako::CRenderSpec::optionalContent |
The optional content object for the document.
| eOptionalContentEvent JawsMako::CRenderSpec::optionalContentEvent |
The type of optional content event to use when testing for the visibility of the optional content. If optionalContent is provided, this must not be eOCUnknown.
| CColorManagerConfigPtr JawsMako::CRenderSpec::overrideCmmConfig |
An optional CMM configuration override to apply to the given render.
| CRenderPostProcessVect JawsMako::CRenderSpec::postProcesses |
A chain of post processing operations to be performed once rendering to the process space is complete. This can include tone curves, device simulation, spot merging/spot overprint simulation and/or preview generation. Please see IPostProcessSpec for further information.
| eBlackPreservation JawsMako::CRenderSpec::preserveBlackForOther |
Whether or not to apply black preservation for non-text objects.
| eBlackPreservation JawsMako::CRenderSpec::preserveBlackForText |
Whether or not to apply black preservation for text.
| IDOMColorSpacePtr JawsMako::CRenderSpec::processSpace |
The desired process color space for initial rendering. This describes the process space where compositing will occur
| IDOMColorSpaceDeviceN::CColorantInfoVect JawsMako::CRenderSpec::replacementSpotColors |
A set of replacement colorants for named spot colorants in the render. Used only when decomposeDeviceN is enabled. The alternate space for each colorant must be specified. See decomposeDeviceN for details.
| CSpotColorNames JawsMako::CRenderSpec::retainedSpotColors |
Spot components to generate as distinct separations/channels.
| eRenderingIntent JawsMako::CRenderSpec::rgbImageRenderingIntent |
The rendering intent to be used for rgb images. If eRenderingIntentUnset, the DOM intent will be used.
| FRect JawsMako::CRenderSpec::sourceRect |
The source area of the DOM that will be mapped to the output width and height.
| bool JawsMako::CRenderSpec::use16BitInternalRendering |
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.
| uint32 JawsMako::CRenderSpec::width |
The width, in pixels, of the result.