GraphicState Class Documentation
classGraphicStateNamespace:datalogics_interface
Detailed Description
The graphics state holds the parameters that describe graphics within that file.
These parameters define how individual graphics are presented on the page, including layers and transparencies.
Uses types
Constructor & Destructor Documentation
GraphicState
GraphicState()Create a new default GraphicState.
GraphicState
GraphicState(GraphicState &&)Parameters
~GraphicState
~GraphicState()Member Function Documentation
clear_extended_graphic_state
voidclear_extended_graphic_state()Returns:
voidRemoves the extended graphic state from this graphic state.
get_dash_pattern
std::vector< double >get_dash_pattern()Returns:
A list containing the dash phase followed by the contents of the DashPattern.The line DashPattern controls the pattern of dashes and gaps used to stroke paths. It is specified by a dash phase and then a series of elements of a DashPattern list. The DashPattern's members are numbers that specify the lengths of alternating dashes and gaps; the numbers must be nonnegative and not all zero. The dash phase specifies the distance into the dash pattern at which to start the dash. The elements of both the DashPattern List and the dash phase are expressed in user space units. This retrieves the DashPattern used by the Pattern list current graphic state.
get_extended_graphic_state
ExtendedGraphicState *get_extended_graphic_state()Returns:
The ExtendedGraphicState, or null if none is set.The ExtendedGraphicState associated with this GraphicState.
The ExtendedGraphicState can contain additional parameters such as transparency, blend mode, and overprint settings that are not part of the basic GraphicState.
get_fill_color
Colorget_fill_color()Returns:
The current fill color.The color used for filling operations in the current GraphicState.
get_line_cap
LineCapget_line_cap()Returns:
The current line cap style.The line cap style used by the current GraphicState, specifying the shape at the ends of open subpaths when stroked.
get_line_flatness
doubleget_line_flatness()Returns:
The current line flatness value.The line flatness tolerance in the current GraphicState, corresponding to the i operator. Default is 1.0.
Flatness controls the maximum distance (in device pixels) between a curve and the flattened line segments that approximate it.
get_line_join
LineJoinget_line_join()Returns:
The current line join style.The line join style used by the current GraphicState, specifying the shape at the corners where consecutive segments of a path connect at an angle.
get_miter_limit
doubleget_miter_limit()Returns:
The current miter limit.The miter limit for line joins in the current GraphicState, corresponding to the M operator. Default is 10.0.
When two line segments meet at a sharp angle and mitered joins have been specified, the miter limit controls when the join is beveled instead.
get_render_intent
RenderIntentget_render_intent()Returns:
The current rendering intent.The color rendering intent for the current GraphicState, corresponding to the Intent key in the image dictionary. The default is RelColorimetric.
get_stroke_color
Colorget_stroke_color()Returns:
The current stroke color.The color used for stroking operations in the current GraphicState.
get_width
doubleget_width()Returns:
The current line width.The line width used for stroking operations by the current GraphicState, in user space units.
operator=
GraphicState &operator=(GraphicState &&)Parameters
Returns:
GraphicState &set_dash_pattern
voidset_dash_pattern(const std::vector< double > &pattern)Parameters
pattern: const std::vector< double > &A list containing the dash phase followed by the contents of the DashPattern.
Returns:
voidThe line DashPattern controls the pattern of dashes and gaps used to stroke paths. It is specified by a dash phase and then a series of elements of a DashPattern list. The DashPattern's members are numbers that specify the lengths of alternating dashes and gaps; the numbers must be nonnegative and not all zero. The dash phase specifies the distance into the dash pattern at which to start the dash. The elements of both the DashPattern List and the dash phase are expressed in user space units. This retrieves the DashPattern used by the Pattern list current graphic state.
set_extended_graphic_state
voidset_extended_graphic_state(const ExtendedGraphicState &egs)Parameters
egs: const ExtendedGraphicState &The new ExtendedGraphicState, or null to remove it.
Returns:
voidThe ExtendedGraphicState associated with this GraphicState.
The ExtendedGraphicState can contain additional parameters such as transparency, blend mode, and overprint settings that are not part of the basic GraphicState.
The GraphicState copies the EGS internally.
set_fill_color
voidset_fill_color(Colorcolor)Parameters
color: ColorThe new fill color.
Returns:
voidThe color used for filling operations in the current GraphicState.
The color may be specified in DeviceGray, DeviceRGB, or DeviceCMYK color spaces.
set_line_cap
voidset_line_cap(LineCapcap)Parameters
cap: LineCapThe new line cap style.
Returns:
voidThe line cap style used by the current GraphicState, specifying the shape at the ends of open subpaths when stroked.
set_line_flatness
voidset_line_flatness(doubleflatness)Parameters
flatness: doubleThe new flatness value.
Returns:
voidThe line flatness tolerance in the current GraphicState, corresponding to the i operator. Default is 1.0.
set_line_join
voidset_line_join(LineJoinjoin)Parameters
join: LineJoinThe new line join style.
Returns:
voidThe line join style to be used by the current GraphicState, specifying the shape at the corners where consecutive segments of a path connect at an angle.
set_miter_limit
voidset_miter_limit(doublelimit)Parameters
limit: doubleThe new miter limit value.
Returns:
voidThe miter limit for line joins in the current GraphicState, corresponding to the M operator. Default is 10.0.
set_render_intent
voidset_render_intent(RenderIntentintent)Parameters
intent: RenderIntentThe new rendering intent.
Returns:
voidThe color rendering intent for the current GraphicState, corresponding to the Intent key in the image dictionary. The default is RelColorimetric.
set_stroke_color
voidset_stroke_color(Colorcolor)Parameters
color: ColorThe new stroke color.
Returns:
voidThe color used for stroking operations in the current GraphicState.
The color may be specified in DeviceGray, DeviceRGB, or DeviceCMYK color spaces.
set_width
voidset_width(doublewidth)Parameters
width: doubleThe new line width.
Returns:
voidThe line width used for stroking operations by the current GraphicState, in user space units.