/*
* Copyright 2013 Google Inc.
*
* Use of this source code is governed by a BSD-style license that can be
* found in the LICENSE file.
*/
#ifndef SkPdfGraphicsState_DEFINED
#define SkPdfGraphicsState_DEFINED
#include "SkCanvas.h"
#include "SkPaint.h"
#include "SkPdfConfig.h"
#include "SkPdfUtils.h"
class SkPdfFont;
class SkPdfNativeObject;
class SkPdfResourceDictionary;
class SkPdfSoftMaskDictionary;
/** \class SkPdfColorOperator
* Operates on stroking or non-stroking properties.
*/
class SkPdfColorOperator {
/*
color space name or array The current color space in which color values are to be interpreted
(see Section 4.5, “Color Spaces”). There are two separate color space
parameters: one for stroking and one for all other painting opera-
tions. Initial value: DeviceGray.
*/
// TODO(edisonn): implement the array part too
// TODO(edisonn): remove this public, let fields be private
public:
NotOwnedString fColorSpace;
SkPdfNativeObject* fPattern;
/*
color (various) The current color to be used during painting operations (see Section
4.5, “Color Spaces”). The type and interpretation of this parameter
depend on the current color space; for most color spaces, a color
value consists of one to four numbers. There are two separate color
parameters: one for stroking and one for all other painting opera-
tions. Initial value: black.
*/
SkColor fColor;
double fOpacity; // ca or CA
public:
void setRGBColor(SkColor color) {
// TODO(edisonn): ASSERT DeviceRGB is the color space.
fPattern = NULL;
fColor = color;
}
// TODO(edisonn): implement the default values for all fields.
SkPdfColorOperator() : fPattern(NULL), fColor(SK_ColorBLACK), fOpacity(1) {
NotOwnedString::init(&fColorSpace, "DeviceRGB");
}
void setColorSpace(NotOwnedString* colorSpace) {
fColorSpace = *colorSpace;
fPattern = NULL;
}
void setPatternColorSpace(SkPdfNativeObject* pattern) {
fColorSpace.fBuffer = (const unsigned char*)"Pattern";
fColorSpace.fBytes = 7; // strlen("Pattern")
fPattern = pattern;
}
void applyGraphicsState(SkPaint* paint) {
paint->setColor(SkColorSetA(fColor, (U8CPU)(fOpacity * 255)));
}
};
/**
* Operates on stroking or non-stroking properties.
*/
struct SkPdfGraphicsState {
// TODO(edisonn): deprecate and remove these!
double fCurPosX;
double fCurPosY;
double fCurFontSize;
bool fTextBlock;
SkPdfFont* fSkFont;
SkPath fPath;
bool fPathClosed;
double fTextLeading;
double fWordSpace;
double fCharSpace;
SkPdfResourceDictionary* fResources;
// TODO(edisonn): Can we move most of these in canvas/paint?
// Might need to strore some properties in 2 paints (stroking paint and non stroking paint)
// TABLE 4.2 Device-independent graphics state parameters
/*
* CTM array The current transformation matrix, which maps positions from user
coordinates to device coordinates (see Section 4.2, “Coordinate Sys-
tems”). This matrix is modified by each application of the coordi-
nate transformation operator, cm. Initial value: a matrix that
transforms default user coordinates to device coordinates.
*/
SkMatrix fCTM;
SkMatrix fContentStreamMatrix;
/*
clipping path (internal) The current clipping path, which defines the boundary against
which all output is to be cropped (see Section 4.4.3, “Clipping Path
Operators”). Initial value: the boundary of the entire imageable
portion of the output page.
*/
// Clip that is applied after the drawing is done!!!
bool fHasClipPathToApply;
SkPath fClipPath;
SkPdfColorOperator fStroking;
SkPdfColorOperator fNonStroking;
/*
text state (various) A set of nine graphics state parameters that pertain only to the
painting of text. These include parameters that select the font, scale
the glyphs to an appropriate size, and accomplish other effects. The
text state parameters are described in Section 5.2, “Text State
Parameters and Operators.”
*/
// TODO(edisonn): add SkPdfTextState class. remove these two existing fields
SkMatrix fMatrixTm;
SkMatrix fMatrixTlm;
/*
line width number The thickness, in user space units, of paths to be stroked (see “Line
Width” on page 152). Initial value: 1.0.
*/
double fLineWidth;
/*
line cap integer A code specifying the shape of the endpoints for any open path that
is stroked (see “Line Cap Style” on page 153). Initial value: 0, for
square butt caps.
*/
// TODO (edisonn): implement defaults - page 153
int fLineCap;
/*
line join integer A code specifying the shape of joints between connected segments
of a stroked path (see “Line Join Style” on page 153). Initial value: 0,
for mitered joins.
*/
// TODO (edisonn): implement defaults - page 153
int fLineJoin;
/*
miter limit number The maximum length of mitered line joins for stroked paths (see
“Miter Limit” on page 153). This parameter limits the length of
“spikes” produced when line segments join at sharp angles. Initial
value: 10.0, for a miter cutoff below approximately 11.5 degrees.
*/
// TODO (edisonn): implement defaults - page 153
double fMiterLimit;
/*
dash pattern array and A description of the dash pattern to be used when paths are
number stroked (see “Line Dash Pattern” on page 155). Initial value: a solid
line.
*/
SkScalar fDashArray[256]; // TODO(edisonn): allocate array?
int fDashArrayLength;
SkScalar fDashPhase;
/*
rendering intent name The rendering intent to be used when converting CIE-based colors
to device colors (see “Rendering Intents” on page 197). Default
value: RelativeColorimetric.
*/
// TODO(edisonn): seems paper only. Verify.
/*
stroke adjustment boolean (PDF 1.2) A flag specifying whether to compensate for possible ras-
terization effects when stroking a path with a line width that is
small relative to the pixel resolution of the output device (see Sec-
tion 6.5.4, “Automatic Stroke Adjustment”). Note that this is con-
sidered a device-independent parameter, even though the details of
its effects are device-dependent. Initial value: false.
*/
// TODO(edisonn): stroke adjustment low priority.
/*
blend mode name or array (PDF 1.4) The current blend mode to be used in the transparent
imaging model (see Sections 7.2.4, “Blend Mode,” and 7.5.2, “Spec-
ifying Blending Color Space and Blend Mode”). This parameter is
implicitly reset to its initial value at the beginning of execution of a
transparency group XObject (see Section 7.5.5, “Transparency
Group XObjects”). Initial value: Normal.
*/
SkXfermode::Mode fBlendModes[256];
int fBlendModesLength;
/*
soft mask dictionary (PDF 1.4) A soft-mask dictionary (see “Soft-Mask Dictionaries” on
or name page 445) specifying the mask shape or mask opacity values to be
used in the transparent imaging model (see “Source Shape and
Opacity” on page 421 and “Mask Shape and Opacity” on page 443),
or the name None if no such mask is specified. This parameter is
implicitly reset to its initial value at the beginning of execution of a
transparency group XObject (see Section 7.5.5, “Transparency
Group XObjects”). Initial value: None.
*/
SkPdfSoftMaskDictionary* fSoftMaskDictionary;
// TODO(edisonn): make sMask private, add setter and getter, ref/unref/..., at the moment we most likely leask
SkBitmap* fSMask;
/*
alpha constant number (PDF 1.4) The constant shape or constant opacity value to be used
in the transparent imaging model (see “Source Shape and Opacity”
on page 421 and “Constant Shape and Opacity” on page 444).
There are two separate alpha constant parameters: one for stroking
and one for all other painting operations. This parameter is implic-
itly reset to its initial value at the beginning of execution of a trans-
parency group XObject (see Section 7.5.5, “Transparency Group
XObjects”). Initial value: 1.0.
*/
double fAphaConstant;
/*
alpha source boolean (PDF 1.4) A flag specifying whether the current soft mask and alpha
constant parameters are to be interpreted as shape values (true) or
opacity values (false). This flag also governs the interpretation of
the SMask entry, if any, in an image dictionary (see Section 4.8.4,
“Image Dictionaries”). Initial value: false.
*/
bool fAlphaSource;
// TODO(edisonn): Device-dependent seem to be required only on the actual physical printer?
// TABLE 4.3 Device-dependent graphics state parameters
/*
overprint boolean (PDF 1.2) A flag specifying (on output devices that support the
overprint control feature) whether painting in one set of colorants
should cause the corresponding areas of other colorants to be
erased (false) or left unchanged (true); see Section 4.5.6, “Over-
print Control.” In PDF 1.3, there are two separate overprint param-
eters: one for stroking and one for all other painting operations.
Initial value: false.
*/
/*
overprint mode number (PDF 1.3) A code specifying whether a color component value of 0
in a DeviceCMYK color space should erase that component (0) or
leave it unchanged (1) when overprinting (see Section 4.5.6, “Over-
print Control”). Initial value: 0.
*/
/*
black generation function (PDF 1.2) A function that calculates the level of the black color
or name component to use when converting RGB colors to CMYK (see Sec-
tion 6.2.3, “Conversion from DeviceRGB to DeviceCMYK”). Initial
value: installation-dependent.
*/
/*
undercolor removal function (PDF 1.2) A function that calculates the reduction in the levels of
or name the cyan, magenta, and yellow color components to compensate for
the amount of black added by black generation (see Section 6.2.3,
“Conversion from DeviceRGB to DeviceCMYK”). Initial value: in-
stallation-dependent.
*/
/*
transfer function, (PDF 1.2) A function that adjusts device gray or color component
array, or name levels to compensate for nonlinear response in a particular out-
put device (see Section 6.3, “Transfer Functions”). Initial value:
installation-dependent.
*/
/*
halftone dictionary, (PDF 1.2) A halftone screen for gray and color rendering, specified
stream, or name as a halftone dictionary or stream (see Section 6.4, “Halftones”).
Initial value: installation-dependent.
*/
/*
flatness number The precision with which curves are to be rendered on the output
device (see Section 6.5.1, “Flatness Tolerance”). The value of this
parameter gives the maximum error tolerance, measured in output
device pixels; smaller numbers give smoother curves at the expense
of more computation and memory use. Initial value: 1.0.
*/
/*
smoothness number (PDF 1.3) The precision with which color gradients are to be ren-
dered on the output device (see Section 6.5.2, “Smoothness Toler-
ance”). The value of this parameter gives the maximum error
tolerance, expressed as a fraction of the range of each color compo-
nent; smaller numbers give smoother color transitions at the
expense of more computation and memory use. Initial value:
installation-dependent.
*/
// TODO(edisonn): some defaults are contextual, they could on colorspace, pdf version, ...
SkPdfGraphicsState() {
fCurPosX = 0.0;
fCurPosY = 0.0;
fCurFontSize = 0.0;
fTextBlock = false;
fCTM = SkMatrix::I();
fMatrixTm = SkMatrix::I();
fMatrixTlm = SkMatrix::I();
fPathClosed = true;
fLineWidth = 0;
fTextLeading = 0;
fWordSpace = 0;
fCharSpace = 0;
fHasClipPathToApply = false;
fResources = NULL;
fSkFont = NULL;
fLineCap = 0;
fLineJoin = 0;
fMiterLimit = 10.0;
fAphaConstant = 1.0;
fAlphaSource = false;
fDashArrayLength = 0;
fDashPhase = 0;
fBlendModesLength = 1;
fBlendModes[0] = SkXfermode::kSrc_Mode; // PDF: Normal Blend mode
fSMask = NULL;
}
// TODO(edisonn): make two functions instead, stroking and non stoking, avoid branching
void applyGraphicsState(SkPaint* paint, bool stroking);
};
#endif // SkPdfGraphicsState_DEFINED