Mako 8.3.0 API
MakoCore SDK API Documentation
Loading...
Searching...
No Matches
renderspec.h
Go to the documentation of this file.
1/*
2 * Copyright (C) 2024-2025 Global Graphics Software Ltd. All rights reserved.
3 */
4
5#ifndef JAWSMAKO_RENDERSPEC_H
6#define JAWSMAKO_RENDERSPEC_H
7
12#include <memory>
13#include <jawsmako/jawsmako.h>
14#include <jawsmako/types.h>
15#include <edl/icolormanager.h>
16
17namespace JawsMako
18{
19 using namespace EDL;
20
26 class IPostProcessSpec;
51 {
52 public:
53 CSpotColorAlias() = default;
60 CSpotColorAlias(const RawString &_spotName, const RawString &_remappedColorant)
61 {
62 spotName = _spotName;
63 remappedColorant = _remappedColorant;
64 }
67 };
68
72
73
82 {
83 public:
100 virtual ~CRenderSpec() = default;
101
102 // Assign base settings from another render spec
128
129 IDOMColorSpacePtr processSpace;
136 bool alpha;
137
141
162
168
169 IOptionalContentPtr optionalContent;
172
177
180 CColorManagerConfigPtr overrideCmmConfig;
188
229 typedef enum
230 {
232 eBPOn = 1,
233 eBPOff = 2,
235
238 };
239
248 {
249 public:
251 {
252 compress = true;
253 }
254
255 IDOMImagePtr result;
256 bool compress;
257 };
258 #define renderSpecToCImageRenderSpec(rs) (dynamic_cast<CImageRenderSpec *>(rs))
259
266 {
267 public:
269 {
270 compress = true;
271 }
272
274 bool compress;
275 };
276 #define renderSpecToCImagesRenderSpec(rs) (dynamic_cast<CImagesRenderSpec *>(rs))
277
288 {
289 public:
291 {
292 buffer = nullptr;
293 rowStride = 0;
294 hostEndian = true;
295 }
296
297 void *buffer;
301 };
302 #define renderSpecToCFrameBufferRenderSpec(rs) (dynamic_cast<CFrameBufferRenderSpec *>(rs))
303
328 #define renderSpecToCFrameBuffersRenderSpec(rs) (dynamic_cast<CFrameBuffersRenderSpec *>(rs))
329
330
331
369
372
402 {
403 public:
412 static JAWSMAKO_API CColorConversionPostProcessSpecPtr create(const IDOMColorSpacePtr &targetSpace,
415
426 static JAWSMAKO_API CColorConversionPostProcessSpecPtr create(const IDOMICCProfilePtr &deviceLink,
427 const IDOMColorSpacePtr &targetSpace,
430
432 {
433 public:
439 IDOMColorSpacePtr targetSpace;
440 IDOMICCProfilePtr deviceLink;
443
444 bool operator== (const CLogicalStep &other) const
445 {
446 return (other.targetSpace == targetSpace)
447 && (other.deviceLink == deviceLink)
448 && (other.intent == intent)
449 && (other.bpc == bpc);
450 }
451
452 bool operator!= (const CLogicalStep &other) const
453 {
454 return ! (*this == other);
455 }
456 };
458
464 static JAWSMAKO_API CColorConversionPostProcessSpecPtr create(const CLogicalSteps &steps);
465
466 ePostProcessType getType() const override
467 {
468 return ePPTColorConversion;
469 }
470
471 public:
473 };
474 #define obj2CColorConversionPostProcessSpec(obj) CColorConversionPostProcessSpecPtr(dynamic_cast<CColorConversionPostProcessSpec *>((IRCObject *) (obj)), true)
475
476 class CToneCurvesPostProcessSpec;
478
490 {
491 public:
526 static JAWSMAKO_API CToneCurvesPostProcessSpecPtr create(const CEDLVector<CFloatVect> &_toneCurves);
527
528 ePostProcessType getType() const override
529 {
530 return ePPTToneCurves;
531 }
532
533 public:
535 };
536 #define obj2CToneCurvesPostProcessSpec(obj) CToneCurvesPostProcessSpecPtr(dynamic_cast<CToneCurvesPostProcessSpec *>((IRCObject *) (obj)), true)
537
538 class CSpotMergePostProcessSpec;
540
575 {
576 public:
588 static JAWSMAKO_API CSpotMergePostProcessSpecPtr create(const IDOMColorSpaceDeviceN::CColorantInfoVect &_mergeSpotColors,
589 const CEDLVector<CFloatVect> &_toneCurves = CEDLVector<CFloatVect>());
590
591 ePostProcessType getType() const override
592 {
593 return ePPTSpotMerge;
594 }
595
596 public:
599 };
600 #define obj2CSpotMergePostProcessSpec(obj) CSpotMergePostProcessSpecPtr(dynamic_cast<CSpotMergePostProcessSpec *>((IRCObject *) (obj)), true)
601
602 class CInkLimitPostProcessSpec;
604
615 {
616 public:
627 static JAWSMAKO_API CInkLimitPostProcessSpecPtr create(float _maxTotalInk,
628 bool _keepBlack = true);
629
630 ePostProcessType getType() const override
631 {
632 return ePPTInkLimit;
633 }
634
635 public:
638 };
639 #define obj2CInkLimitPostProcessSpec(obj) CInkLimitPostProcessSpecPtr(dynamic_cast<CInkLimitPostProcessSpec *>((IRCObject *) (obj)), true)
640
641 class CHalftonePostProcessSpec;
643
653 {
654 public:
655
657
669 static JAWSMAKO_API CHalftonePostProcessSpecPtr create(const IHalftone *halftone, float dpi);
670
671 ePostProcessType getType() const override
672 {
673 return ePPTHalftone;
674 }
675
676 public:
678 float dpi;
679 };
680 #define obj2CHalftonePostProcessSpec(obj) CHalftonePostProcessSpecPtr(dynamic_cast<CHalftonePostProcessSpec *>((IRCObject *) (obj)), true)
681
682}
683
684#endif /* JAWSMAKO_RENDERSPEC_H */
Definition edlvector.h:30
CEDLVector< CColorantInfo > CColorantInfoVect
Definition idomcolorspace.h:845
Base class Interface for all Reference Counted objects.
Definition ircobject.h:35
bool operator!=(const CLogicalStep &other) const
Definition renderspec.h:452
eRenderingIntent intent
The rendering intent to use.
Definition renderspec.h:441
IDOMColorSpacePtr targetSpace
The target space. Not used for conversion if a device link is supplied.
Definition renderspec.h:439
CLogicalStep()
Definition renderspec.h:434
IDOMICCProfilePtr deviceLink
The device link, if provided.
Definition renderspec.h:440
eBlackPointCompensation bpc
The black point compensation to use.
Definition renderspec.h:442
bool operator==(const CLogicalStep &other) const
Definition renderspec.h:444
This class describes a post-processing step whereby the previous result is color converted to a new c...
Definition renderspec.h:402
CEDLVector< CLogicalStep > CLogicalSteps
Definition renderspec.h:457
ePostProcessType getType() const override
Get the type of post processing this spec represents.
Definition renderspec.h:466
static JAWSMAKO_API CColorConversionPostProcessSpecPtr create(const CLogicalSteps &steps)
Create a color-conversion post process through multiple color spaces and/or links.
static JAWSMAKO_API CColorConversionPostProcessSpecPtr create(const IDOMICCProfilePtr &deviceLink, const IDOMColorSpacePtr &targetSpace, eRenderingIntent intent=eRelativeColorimetric, eBlackPointCompensation bpc=eBPCDefault)
Create a color-conversion post process using a device link profile.
CLogicalSteps conversionSteps
Definition renderspec.h:472
static JAWSMAKO_API CColorConversionPostProcessSpecPtr create(const IDOMColorSpacePtr &targetSpace, eRenderingIntent intent=eRelativeColorimetric, eBlackPointCompensation bpc=eBPCDefault)
Create a color-conversion post process.
int32 rowStride
The distance, in bytes, from one scanline to the next. May be negative.
Definition renderspec.h:298
bool hostEndian
Definition renderspec.h:299
CFrameBufferRenderSpec()
Definition renderspec.h:290
void * buffer
A pointer to the frame buffer memory where the first pixel will be written.
Definition renderspec.h:297
CFrameBufferInfoVect bufferInfo
Definition renderspec.h:318
CFrameBuffersRenderSpec()
Definition renderspec.h:313
bool hostEndian
Definition renderspec.h:325
This class describes a post-processing step whereby halftoning is performed.
Definition renderspec.h:653
float dpi
Definition renderspec.h:678
IJawsRenderer::CSeparatedColorSpotHalftone CSeparatedColorSpotHalftone
Definition renderspec.h:656
static JAWSMAKO_API CHalftonePostProcessSpecPtr create(const IHalftone *halftone, float dpi)
Create a halftone post process.
ePostProcessType getType() const override
Get the type of post processing this spec represents.
Definition renderspec.h:671
const IHalftone * halftone
Definition renderspec.h:677
IDOMImagePtr result
On render completion, this will be populated with the rendered result.
Definition renderspec.h:255
bool compress
If true, the image data will be lightly compressed during render.
Definition renderspec.h:256
CImageRenderSpec()
Definition renderspec.h:250
CDOMImageVect result
On render completion, this will be populated with the rendered result images.
Definition renderspec.h:273
CImagesRenderSpec()
Definition renderspec.h:268
bool compress
If true, the image data will be lightly compressed during render.
Definition renderspec.h:274
This class describes a post-processing step whereby ink limiting via scaling is performed.
Definition renderspec.h:615
static JAWSMAKO_API CInkLimitPostProcessSpecPtr create(float _maxTotalInk, bool _keepBlack=true)
Create an ink-limiting post process.
ePostProcessType getType() const override
Get the type of post processing this spec represents.
Definition renderspec.h:630
bool keepBlack
Definition renderspec.h:637
float maxTotalInk
Definition renderspec.h:636
CSpotColorNames ignoredSpotColors
Spot components to ignore.
Definition renderspec.h:139
CSpotColorAliasVect aliasedSpotColors
Spot colorant aliases. Please see CSpotColorAlias for further information.
Definition renderspec.h:140
uint32 width
The width, in pixels, of the result.
Definition renderspec.h:131
uint8 depth
The depth, in bits (8 or 16), of the result.
Definition renderspec.h:133
CRenderSpec()
Definition renderspec.h:84
IOptionalContentPtr optionalContent
The optional content object for the document.
Definition renderspec.h:169
CColorManagerConfigPtr overrideCmmConfig
An optional CMM configuration override to apply to the given render.
Definition renderspec.h:180
bool alpha
Whether or not alpha information should be produced.
Definition renderspec.h:136
IDOMColorSpaceDeviceN::CColorantInfoVect replacementSpotColors
Definition renderspec.h:158
bool decomposeDeviceN
Definition renderspec.h:142
IDOMColorSpacePtr processSpace
Definition renderspec.h:129
bool ignoreInputIccProfiles
Definition renderspec.h:178
void assignCommon(const CRenderSpec &other)
Definition renderspec.h:103
CSpotColorNames retainedSpotColors
Spot components to generate as distinct separations/channels.
Definition renderspec.h:138
eBlackPreservation preserveBlackForOther
Whether or not to apply black preservation for non-text objects.
Definition renderspec.h:237
virtual ~CRenderSpec()=default
CRenderPostProcessVect postProcesses
Definition renderspec.h:163
eOptionalContentEvent optionalContentEvent
Definition renderspec.h:170
eBlackPreservation preserveBlackForText
Whether or not to apply black preservation for text.
Definition renderspec.h:236
FRect sourceRect
The source area of the DOM that will be mapped to the output width and height.
Definition renderspec.h:134
bool use16BitInternalRendering
Definition renderspec.h:181
uint32 height
The height, in pixels, of the result.
Definition renderspec.h:132
eBlackPreservation
The possible types for enabling/controlling 100% black preservation.
Definition renderspec.h:230
@ eBPDefault
Default behavior.
Definition renderspec.h:231
@ eBPOn
Use black point compensation if applicable during color conversion.
Definition renderspec.h:232
@ eBPOff
Do not use black point compensation during color conversion.
Definition renderspec.h:233
uint8 aaFactor
The aaFactor to be used. 1 means no anti-aliasing. The maximum value is 4.
Definition renderspec.h:135
eRenderingIntent cmykImageRenderingIntent
Definition renderspec.h:175
eRenderingIntent rgbImageRenderingIntent
Definition renderspec.h:173
RawString remappedColorant
The colorant to which occurrences of spotName will be mapped.
Definition renderspec.h:66
RawString spotName
The name of the spot to map.
Definition renderspec.h:65
CSpotColorAlias(const RawString &_spotName, const RawString &_remappedColorant)
Construct a new CSpotColorAlias object.
Definition renderspec.h:60
This class describes a post-processing step whereby one or more spot colorants folded into the proces...
Definition renderspec.h:575
static JAWSMAKO_API CSpotMergePostProcessSpecPtr create(const IDOMColorSpaceDeviceN::CColorantInfoVect &_mergeSpotColors, const CEDLVector< CFloatVect > &_toneCurves=CEDLVector< CFloatVect >())
Create a tone-mapping post process.
CEDLVector< CFloatVect > toneCurves
Definition renderspec.h:598
IDOMColorSpaceDeviceN::CColorantInfoVect mergeSpotColors
Definition renderspec.h:597
ePostProcessType getType() const override
Get the type of post processing this spec represents.
Definition renderspec.h:591
This class describes a post-processing step whereby one or more tone curves (aka calibration curves) ...
Definition renderspec.h:490
CEDLVector< CFloatVect > toneCurves
Definition renderspec.h:534
static JAWSMAKO_API CToneCurvesPostProcessSpecPtr create(const CEDLVector< CFloatVect > &_toneCurves)
Create a tone-mapping post process.
ePostProcessType getType() const override
Get the type of post processing this spec represents.
Definition renderspec.h:528
Description of spot halftones, using Jaws's default spot function. Used for color halftoned rendering...
Definition jawsmako.h:2181
Description of a frame buffer for use with renderSeparationsToFrameBuffers and Apex rendering functio...
Definition jawsmako.h:1869
Description of spot halftones, used for color halftoned rendering. Analogous to a PostScript Type 2 H...
Definition jawsmako.h:2212
Description of a simple spot halftone, at 45 degrees, using Jaws's default spot function....
Definition jawsmako.h:2149
An abstract base class for communicating halftone information to the Jaws renderer,...
Definition jawsmako.h:2137
A class that describes a post process operation to be (logically) performed after an initial render t...
Definition renderspec.h:344
virtual ePostProcessType getType() const =0
Get the type of post processing this spec represents.
@ ePPTColorConversion
Color convert to a new color space.
Definition renderspec.h:353
@ ePPTCustomSpot
Custom spot color manipulation on the GPU with a specially made shader.
Definition renderspec.h:359
@ ePPTInkLimit
Ink limiting via scaling.
Definition renderspec.h:356
@ ePPTCustomSpotMerge
Custom spot merging on the GPU with a specially made shader.
Definition renderspec.h:360
@ ePPTCustomColor
Custom color manipulation on the GPU with a specially made shader.
Definition renderspec.h:358
@ ePPTHalftone
Apply halftone.
Definition renderspec.h:357
@ ePPTSpotMerge
Merge spots.
Definition renderspec.h:355
@ ePPTToneCurves
Apply tone curves.
Definition renderspec.h:354
CEDLVector< IDOMImagePtr > CDOMImageVect
Definition edlfwd.h:55
RectTmpl< double > FRect
Definition edlgeom.h:338
unsigned int uint32
Definition edltypes.h:34
signed int int32
Definition edltypes.h:29
unsigned char uint8
Definition edltypes.h:32
eBlackPointCompensation
Black point compensation enumeration.
Definition edlblackpointcompensation.h:17
eRenderingIntent
Rendering intent enumeration.
Definition edlrenderingintent.h:17
@ eBPCDefault
Default behavior.
Definition edlblackpointcompensation.h:19
@ eRenderingIntentUnset
No rendering intent was set.
Definition edlrenderingintent.h:18
@ eRelativeColorimetric
Relative colorimetric rendering intent.
Definition edlrenderingintent.h:20
ePostProcessType
The possible types of post processing operations.
Definition renderspec.h:352
EDLSysString RawString
A raw, 8 bit string. Encoding depends on context.
Definition types.h:150
Definition apexcustompostprocess.h:17
IJawsRenderer::CFrameBufferInfo CFrameBufferInfo
Definition renderspec.h:21
IJawsRenderer::IHalftone IHalftone
Definition renderspec.h:22
eOptionalContentEvent
Optional content Event types.
Definition types.h:193
@ eOCEView
View.
Definition types.h:195
CEDLVector< U8String > CSpotColorNames
Definition types.h:169
CEDLVector< IPostProcessSpecPtr > CRenderPostProcessVect
Definition renderspec.h:28
IJawsRenderer::CColorSpotHalftone CColorSpotHalftone
Definition renderspec.h:24
CEDLVector< CFrameBufferInfo > CFrameBufferInfoVect
Definition renderspec.h:25
IJawsRenderer::CSpotHalftone CSpotHalftone
Definition renderspec.h:23
CEDLVector< CSpotColorAlias > CSpotColorAliasVect
An alias for a vector of CSpotColorAlias.
Definition renderspec.h:71
#define DECL_SMART_PTR(cls)
Definition smartptr.h:211
#define JAWSMAKO_API
Definition types.h:29