KiCad PCB EDA Suite
PS_PLOTTER Class Reference

#include <plotters_pslike.h>

Inheritance diagram for PS_PLOTTER:
PSLIKE_PLOTTER PLOTTER

Public Member Functions

 PS_PLOTTER ()
 
virtual PLOT_FORMAT GetPlotterType () const override
 Returns the effective plot engine in use. More...
 
virtual bool StartPlot (const wxString &aPageNumber) override
 The code within this function (and the CloseFilePS function) creates postscript files whose contents comply with Adobe's Document Structuring Convention, as documented by assorted details described within the following URLs: More...
 
virtual bool EndPlot () override
 
virtual void SetCurrentLineWidth (int width, void *aData=nullptr) override
 Set the current line width (in IUs) for the next plot. More...
 
virtual void SetDash (int aLineWidth, PLOT_DASH_TYPE aLineStyle) override
 PostScript supports dashed lines. More...
 
virtual void SetViewport (const VECTOR2I &aOffset, double aIusPerDecimil, double aScale, bool aMirror) override
 Set the plot offset and scaling for the current plot. More...
 
virtual void Rect (const VECTOR2I &p1, const VECTOR2I &p2, FILL_T fill, int width=USE_DEFAULT_LINE_WIDTH) override
 
virtual void Circle (const VECTOR2I &pos, int diametre, FILL_T fill, int width=USE_DEFAULT_LINE_WIDTH) override
 
virtual void Arc (const VECTOR2I &aCenter, const VECTOR2I &aStart, const VECTOR2I &aEnd, FILL_T aFill, int aWidth, int aMaxError) override
 Generic fallback: arc rendered as a polyline. More...
 
virtual void PlotPoly (const std::vector< VECTOR2I > &aCornerList, FILL_T aFill, int aWidth=USE_DEFAULT_LINE_WIDTH, void *aData=nullptr) override
 Draw a polygon ( filled or not ). More...
 
virtual void PlotImage (const wxImage &aImage, const VECTOR2I &aPos, double aScaleFactor) override
 PostScript-likes at the moment are the only plot engines supporting bitmaps. More...
 
virtual void PenTo (const VECTOR2I &pos, char plume) override
 Moveto/lineto primitive, moves the 'pen' to the specified direction. More...
 
virtual void Text (const VECTOR2I &aPos, const COLOR4D &aColor, const wxString &aText, const EDA_ANGLE &aOrient, const VECTOR2I &aSize, enum GR_TEXT_H_ALIGN_T aH_justify, enum GR_TEXT_V_ALIGN_T aV_justify, int aWidth, bool aItalic, bool aBold, bool aMultilineAllowed=false, KIFONT::FONT *aFont=nullptr, void *aData=nullptr) override
 Draw text with the plotter. More...
 
virtual void SetTextMode (PLOT_TEXT_MODE mode) override
 PS and PDF fully implement native text (for the Latin-1 subset) More...
 
void SetScaleAdjust (double scaleX, double scaleY)
 Set the 'fine' scaling for the postscript engine. More...
 
virtual void FlashPadCircle (const VECTOR2I &aPadPos, int aDiameter, OUTLINE_MODE aTraceMode, void *aData) override
 
virtual void FlashPadOval (const VECTOR2I &aPadPos, const VECTOR2I &aSize, const EDA_ANGLE &aPadOrient, OUTLINE_MODE aTraceMode, void *aData) override
 
virtual void FlashPadRect (const VECTOR2I &aPadPos, const VECTOR2I &aSize, const EDA_ANGLE &aPadOrient, OUTLINE_MODE aTraceMode, void *aData) override
 
virtual void FlashPadRoundRect (const VECTOR2I &aPadPos, const VECTOR2I &aSize, int aCornerRadius, const EDA_ANGLE &aOrient, OUTLINE_MODE aTraceMode, void *aData) override
 
virtual void FlashPadCustom (const VECTOR2I &aPadPos, const VECTOR2I &aSize, const EDA_ANGLE &aOrient, SHAPE_POLY_SET *aPolygons, OUTLINE_MODE aTraceMode, void *aData) override
 
virtual void FlashPadTrapez (const VECTOR2I &aPadPos, const VECTOR2I *aCorners, const EDA_ANGLE &aPadOrient, OUTLINE_MODE aTraceMode, void *aData) override
 Flash a trapezoidal pad. More...
 
virtual void FlashRegularPolygon (const VECTOR2I &aShapePos, int aDiameter, int aCornerCount, const EDA_ANGLE &aOrient, OUTLINE_MODE aTraceMode, void *aData) override
 Flash a regular polygon. More...
 
virtual void SetColor (const COLOR4D &color) override
 The SetColor implementation is split with the subclasses: The PSLIKE computes the rgb values, the subclass emits the operator to actually do it. More...
 
virtual void SetNegative (bool aNegative)
 
virtual void SetColorMode (bool aColorMode)
 Plot in B/W or color. More...
 
bool GetColorMode () const
 
void SetRenderSettings (RENDER_SETTINGS *aSettings)
 
RENDER_SETTINGSRenderSettings ()
 
virtual void SetPageSettings (const PAGE_INFO &aPageSettings)
 
PAGE_INFOPageSettings ()
 
virtual int GetCurrentLineWidth () const
 
virtual void SetCreator (const wxString &aCreator)
 
virtual void SetTitle (const wxString &aTitle)
 
void AddLineToHeader (const wxString &aExtraString)
 Add a line to the list of free lines to print at the beginning of the file. More...
 
void ClearHeaderLinesList ()
 Remove all lines from the list of free lines to print at the beginning of the file. More...
 
virtual bool OpenFile (const wxString &aFullFilename)
 Open or create the plot file aFullFilename. More...
 
double GetIUsPerDecimil () const
 The IUs per decimil are an essential scaling factor when plotting; they are set and saved when establishing the viewport. More...
 
int GetPlotterArcLowDef () const
 
int GetPlotterArcHighDef () const
 
virtual void BezierCurve (const VECTOR2I &aStart, const VECTOR2I &aControl1, const VECTOR2I &aControl2, const VECTOR2I &aEnd, int aTolerance, int aLineThickness=USE_DEFAULT_LINE_WIDTH)
 Generic fallback: Cubic Bezier curve rendered as a polyline In KiCad the bezier curves have 4 control points: start ctrl1 ctrl2 end. More...
 
void MoveTo (const VECTOR2I &pos)
 
void LineTo (const VECTOR2I &pos)
 
void FinishTo (const VECTOR2I &pos)
 
void PenFinish ()
 
virtual void PlotPoly (const SHAPE_LINE_CHAIN &aCornerList, FILL_T aFill, int aWidth=USE_DEFAULT_LINE_WIDTH, void *aData=nullptr)
 Draw a polygon ( filled or not ). More...
 
virtual void ThickSegment (const VECTOR2I &start, const VECTOR2I &end, int width, OUTLINE_MODE tracemode, void *aData)
 
virtual void ThickArc (const VECTOR2I &aCentre, const VECTOR2I &aStart, const VECTOR2I &aEnd, int aWidth, OUTLINE_MODE aTraceMode, void *aData)
 
virtual void ThickArc (const EDA_SHAPE &aArcShape, OUTLINE_MODE aTraceMode, void *aData)
 
virtual void ThickRect (const VECTOR2I &p1, const VECTOR2I &p2, int width, OUTLINE_MODE tracemode, void *aData)
 
virtual void ThickCircle (const VECTOR2I &pos, int diametre, int width, OUTLINE_MODE tracemode, void *aData)
 
virtual void FilledCircle (const VECTOR2I &pos, int diametre, OUTLINE_MODE tracemode, void *aData)
 
virtual void HyperlinkBox (const BOX2I &aBox, const wxString &aDestinationURL)
 Create a clickable hyperlink with a rectangular click area. More...
 
virtual void HyperlinkMenu (const BOX2I &aBox, const std::vector< wxString > &aDestURLs)
 Create a clickable hyperlink menu with a rectangular click area. More...
 
virtual void Bookmark (const BOX2I &aBox, const wxString &aName, const wxString &aGroupName=wxEmptyString)
 Create a bookmark to a symbol. More...
 
void Marker (const VECTOR2I &position, int diametre, unsigned aShapeId)
 Draw a pattern shape number aShapeId, to coord position. More...
 
virtual void SetLayerPolarity (bool aPositive)
 Set the current Gerber layer polarity to positive or negative by writing %LPD*% or %LPC*% to the Gerber file, respectively. More...
 
virtual void SetGerberCoordinatesFormat (int aResolution, bool aUseInches=false)
 
virtual void SetSvgCoordinatesFormat (unsigned aPrecision)
 Set the number of digits for mantissa in coordinates in mm for SVG plotter. More...
 
virtual void StartBlock (void *aData)
 calling this function allows one to define the beginning of a group of drawing items, for instance in SVG or Gerber format. More...
 
virtual void EndBlock (void *aData)
 calling this function allows one to define the end of a group of drawing items for instance in SVG or Gerber format. More...
 

Static Public Member Functions

static wxString GetDefaultFileExtension ()
 

Static Public Attributes

static const int DO_NOT_SET_LINE_WIDTH = -2
 
static const int USE_DEFAULT_LINE_WIDTH = -1
 
static const unsigned MARKER_COUNT = 58
 Draw a marker (used for the drill map). More...
 

Protected Member Functions

virtual void emitSetRGBColor (double r, double g, double b, double a) override
 Virtual primitive for emitting the setrgbcolor operator. More...
 
void computeTextParameters (const VECTOR2I &aPos, const wxString &aText, const EDA_ANGLE &aOrient, const VECTOR2I &aSize, bool aMirror, enum GR_TEXT_H_ALIGN_T aH_justify, enum GR_TEXT_V_ALIGN_T aV_justify, int aWidth, bool aItalic, bool aBold, double *wideningFactor, double *ctm_a, double *ctm_b, double *ctm_c, double *ctm_d, double *ctm_e, double *ctm_f, double *heightFactor)
 This is the core for postscript/PDF text alignment. More...
 
void postscriptOverlinePositions (const wxString &aText, int aXSize, bool aItalic, bool aBold, std::vector< int > *pos_pairs)
 Computes the x coordinates for the overlining in a string of text. More...
 
virtual std::string encodeStringForPlotter (const wxString &aUnicode)
 convert a wxString unicode string to a char string compatible with the accepted string plotter format (convert special chars and non ascii7 chars) More...
 
int returnPostscriptTextWidth (const wxString &aText, int aXSize, bool aItalic, bool aBold)
 Sister function for the GraphicTextWidth in drawtxt.cpp Does the same processing (i.e. More...
 
virtual void Arc (const VECTOR2I &aCentre, const EDA_ANGLE &aStartAngle, const EDA_ANGLE &aEndAngle, int aRadius, FILL_T aFill, int aWidth=USE_DEFAULT_LINE_WIDTH)
 Generic fallback: arc rendered as a polyline. More...
 
virtual void ThickArc (const VECTOR2I &aCentre, const EDA_ANGLE &StAngle, const EDA_ANGLE &EndAngle, int aRadius, int aWidth, OUTLINE_MODE aTraceMode, void *aData)
 
void markerCircle (const VECTOR2I &pos, int radius)
 Plot a circle centered on the position. More...
 
void markerHBar (const VECTOR2I &pos, int radius)
 Plot a - bar centered on the position. More...
 
void markerSlash (const VECTOR2I &pos, int radius)
 Plot a / bar centered on the position. More...
 
void markerBackSlash (const VECTOR2I &pos, int radius)
 Plot a \ bar centered on the position. More...
 
void markerVBar (const VECTOR2I &pos, int radius)
 Plot a | bar centered on the position. More...
 
void markerSquare (const VECTOR2I &position, int radius)
 Plot a square centered on the position. More...
 
void markerLozenge (const VECTOR2I &position, int radius)
 Plot a lozenge centered on the position. More...
 
void segmentAsOval (const VECTOR2I &start, const VECTOR2I &end, int width, OUTLINE_MODE tracemode)
 Convert a thick segment and plot it as an oval. More...
 
void sketchOval (const VECTOR2I &aPos, const VECTOR2I &aSize, const EDA_ANGLE &aOrient, int aWidth)
 
virtual VECTOR2D userToDeviceCoordinates (const VECTOR2I &aCoordinate)
 Modify coordinates according to the orientation, scale factor, and offsets trace. More...
 
virtual VECTOR2D userToDeviceSize (const VECTOR2I &size)
 Modify size according to the plotter scale factors (VECTOR2I version, returns a VECTOR2D). More...
 
virtual double userToDeviceSize (double size) const
 Modify size according to the plotter scale factors (simple double version). More...
 
double GetDotMarkLenIU (int aLineWidth) const
 
double GetDashMarkLenIU (int aLineWidth) const
 
double GetDashGapLenIU (int aLineWidth) const
 

Protected Attributes

double plotScaleAdjX
 Fine user scale adjust ( = 1.0 if no correction) More...
 
double plotScaleAdjY
 
PLOT_TEXT_MODE m_textMode
 How to draw text. More...
 
double m_plotScale
 Plot scale - chosen by the user (even implicitly with 'fit in a4') More...
 
double m_IUsPerDecimil
 
double m_iuPerDeviceUnit
 
VECTOR2I m_plotOffset
 
bool m_plotMirror
 
bool m_mirrorIsHorizontal
 
bool m_yaxisReversed
 
FILE * m_outputFile
 Output file. More...
 
bool m_colorMode
 
bool m_negativeMode
 
int m_currentPenWidth
 
char m_penState
 
VECTOR2I m_penLastpos
 
wxString m_creator
 
wxString m_filename
 
wxString m_title
 
PAGE_INFO m_pageInfo
 
VECTOR2I m_paperSize
 
wxArrayString m_headerExtraLines
 
RENDER_SETTINGSm_renderSettings
 

Static Protected Attributes

static const double postscriptTextAscent = 0.718
 Height of the postscript font (from the AFM) More...
 

Detailed Description

Definition at line 155 of file plotters_pslike.h.

Constructor & Destructor Documentation

◆ PS_PLOTTER()

PS_PLOTTER::PS_PLOTTER ( )
inline

Definition at line 158 of file plotters_pslike.h.

159 {
160 // The phantom plot in postscript is an hack and reportedly
161 // crashes Adobe's own postscript interpreter!
163 }
PLOT_TEXT_MODE m_textMode
How to draw text.

References PSLIKE_PLOTTER::m_textMode, and STROKE.

Member Function Documentation

◆ AddLineToHeader()

void PLOTTER::AddLineToHeader ( const wxString &  aExtraString)
inlineinherited

Add a line to the list of free lines to print at the beginning of the file.

Parameters
aExtraStringis the string to print

Definition at line 168 of file plotter.h.

169 {
170 m_headerExtraLines.Add( aExtraString );
171 }
wxArrayString m_headerExtraLines
Definition: plotter.h:648

References PLOTTER::m_headerExtraLines.

Referenced by AddGerberX2Attribute(), AddGerberX2Header(), GERBER_WRITER::createDrillFile(), PLACEFILE_GERBER_WRITER::CreatePlaceFile(), and GENDRILL_WRITER_BASE::genDrillMapFile().

◆ Arc() [1/2]

void PS_PLOTTER::Arc ( const VECTOR2I aCenter,
const VECTOR2I aStart,
const VECTOR2I aEnd,
FILL_T  aFill,
int  aWidth,
int  aMaxError 
)
overridevirtual

Generic fallback: arc rendered as a polyline.

Reimplemented from PLOTTER.

Definition at line 574 of file PS_plotter.cpp.

576{
577 wxASSERT( m_outputFile );
578
579 VECTOR2D center_device = userToDeviceCoordinates( aCenter );
580 VECTOR2D start_device = userToDeviceCoordinates( aStart );
581 VECTOR2D end_device = userToDeviceCoordinates( aEnd );
582 double radius_device = ( start_device - center_device ).EuclideanNorm();
583 EDA_ANGLE startAngle( mapCoords( start_device - center_device ) );
584 EDA_ANGLE endAngle( mapCoords( end_device - center_device ) );
585
586 // userToDeviceCoordinates gets our start/ends out of order
587 std::swap( startAngle, endAngle );
588
589 SetCurrentLineWidth( aWidth );
590
591 fprintf( m_outputFile, "%g %g %g %g %g arc%d\n",
592 center_device.x,
593 center_device.y,
594 radius_device,
595 startAngle.AsDegrees(),
596 endAngle.AsDegrees(),
597 getFillId( aFill ) );
598}
VECTOR2D mapCoords(const VECTOR2D &aSource)
Definition: PS_plotter.cpp:568
static int getFillId(FILL_T aFill)
Definition: PS_plotter.cpp:50
virtual VECTOR2D userToDeviceCoordinates(const VECTOR2I &aCoordinate)
Modify coordinates according to the orientation, scale factor, and offsets trace.
Definition: plotter.cpp:90
FILE * m_outputFile
Output file.
Definition: plotter.h:633
virtual void SetCurrentLineWidth(int width, void *aData=nullptr) override
Set the current line width (in IUs) for the next plot.
Definition: PS_plotter.cpp:473
double EuclideanNorm(const VECTOR2I &vector)
Definition: trigo.h:129

References EDA_ANGLE::AsDegrees(), EuclideanNorm(), getFillId(), PLOTTER::m_outputFile, mapCoords(), SetCurrentLineWidth(), PLOTTER::userToDeviceCoordinates(), VECTOR2< T >::x, and VECTOR2< T >::y.

◆ Arc() [2/2]

void PLOTTER::Arc ( const VECTOR2I aCentre,
const EDA_ANGLE aStartAngle,
const EDA_ANGLE aEndAngle,
int  aRadius,
FILL_T  aFill,
int  aWidth = USE_DEFAULT_LINE_WIDTH 
)
protectedvirtualinherited

Generic fallback: arc rendered as a polyline.

Reimplemented in DXF_PLOTTER, GERBER_PLOTTER, HPGL_PLOTTER, PDF_PLOTTER, and SVG_PLOTTER.

Definition at line 175 of file plotter.cpp.

177{
178 EDA_ANGLE startAngle( aStartAngle );
179 EDA_ANGLE endAngle( aEndAngle );
180 const EDA_ANGLE delta( 5.0, DEGREES_T ); // increment to draw arc
181 VECTOR2I start, end;
182 const int sign = -1;
183
184 if( startAngle > endAngle )
185 std::swap( startAngle, endAngle );
186
187 SetCurrentLineWidth( aWidth );
188
189 start.x = aCenter.x + KiROUND( aRadius * startAngle.Cos() );
190 start.y = aCenter.y + sign*KiROUND( aRadius * startAngle.Sin() );
191
192 if( aFill != FILL_T::NO_FILL )
193 {
194 MoveTo( aCenter );
195 LineTo( start );
196 }
197 else
198 {
199 MoveTo( start );
200 }
201
202 for( EDA_ANGLE ii = startAngle + delta; ii < endAngle; ii += delta )
203 {
204 end.x = aCenter.x + KiROUND( aRadius * ii.Cos() );
205 end.y = aCenter.y + sign*KiROUND( aRadius * ii.Sin() );
206 LineTo( end );
207 }
208
209 end.x = aCenter.x + KiROUND( aRadius * endAngle.Cos() );
210 end.y = aCenter.y + sign*KiROUND( aRadius * endAngle.Sin() );
211
212 if( aFill != FILL_T::NO_FILL )
213 {
214 LineTo( end );
215 FinishTo( aCenter );
216 }
217 else
218 {
219 FinishTo( end );
220 }
221}
void MoveTo(const VECTOR2I &pos)
Definition: plotter.h:247
void FinishTo(const VECTOR2I &pos)
Definition: plotter.h:257
virtual void SetCurrentLineWidth(int width, void *aData=nullptr)=0
Set the line width for the next drawing.
void LineTo(const VECTOR2I &pos)
Definition: plotter.h:252
@ DEGREES_T
Definition: eda_angle.h:31
constexpr int delta
int sign(T val)
Definition: util.h:124
constexpr ret_type KiROUND(fp_type v)
Round a floating point number to an integer using "round halfway cases away from zero".
Definition: util.h:85

References EDA_ANGLE::Cos(), DEGREES_T, delta, PLOTTER::FinishTo(), KiROUND(), PLOTTER::LineTo(), PLOTTER::MoveTo(), NO_FILL, PLOTTER::SetCurrentLineWidth(), sign(), EDA_ANGLE::Sin(), VECTOR2< T >::x, and VECTOR2< T >::y.

◆ BezierCurve()

void PLOTTER::BezierCurve ( const VECTOR2I aStart,
const VECTOR2I aControl1,
const VECTOR2I aControl2,
const VECTOR2I aEnd,
int  aTolerance,
int  aLineThickness = USE_DEFAULT_LINE_WIDTH 
)
virtualinherited

Generic fallback: Cubic Bezier curve rendered as a polyline In KiCad the bezier curves have 4 control points: start ctrl1 ctrl2 end.

Reimplemented in SVG_PLOTTER.

Definition at line 224 of file plotter.cpp.

227{
228 // Generic fallback: Quadratic Bezier curve plotted as a polyline
229 int minSegLen = aLineThickness; // The segment min length to approximate a bezier curve
230
231 std::vector<VECTOR2I> ctrlPoints;
232 ctrlPoints.reserve( 4 );
233
234 ctrlPoints.push_back( aStart );
235 ctrlPoints.push_back( aControl1 );
236 ctrlPoints.push_back( aControl2 );
237 ctrlPoints.push_back( aEnd );
238
239 BEZIER_POLY bezier_converter( ctrlPoints );
240
241 std::vector<VECTOR2I> approxPoints;
242 bezier_converter.GetPoly( approxPoints, minSegLen );
243
244 SetCurrentLineWidth( aLineThickness );
245 MoveTo( aStart );
246
247 for( unsigned ii = 1; ii < approxPoints.size()-1; ii++ )
248 LineTo( approxPoints[ii] );
249
250 FinishTo( aEnd );
251}
Bezier curves to polygon converter.
Definition: bezier_curves.h:36

References PLOTTER::FinishTo(), BEZIER_POLY::GetPoly(), PLOTTER::LineTo(), PLOTTER::MoveTo(), and PLOTTER::SetCurrentLineWidth().

Referenced by SVG_PLOTTER::BezierCurve(), BRDITEMS_PLOTTER::PlotFootprintShape(), and BRDITEMS_PLOTTER::PlotPcbShape().

◆ Bookmark()

virtual void PLOTTER::Bookmark ( const BOX2I aBox,
const wxString &  aName,
const wxString &  aGroupName = wxEmptyString 
)
inlinevirtualinherited

Create a bookmark to a symbol.

@aBox is the bounding box of the symbol @aSymbolReference is the symbol schematic ref

Reimplemented in PDF_PLOTTER.

Definition at line 457 of file plotter.h.

459 {
460 // NOP for most plotters.
461 }

Referenced by SCH_LABEL_BASE::Plot(), SCH_SYMBOL::Plot(), and PlotStandardLayer().

◆ Circle()

void PS_PLOTTER::Circle ( const VECTOR2I pos,
int  diametre,
FILL_T  fill,
int  width = USE_DEFAULT_LINE_WIDTH 
)
overridevirtual

Implements PLOTTER.

Definition at line 557 of file PS_plotter.cpp.

558{
559 wxASSERT( m_outputFile );
560 VECTOR2D pos_dev = userToDeviceCoordinates( pos );
561 double radius = userToDeviceSize( diametre / 2.0 );
562
563 SetCurrentLineWidth( width );
564 fprintf( m_outputFile, "%g %g %g cir%d\n", pos_dev.x, pos_dev.y, radius, getFillId( fill ) );
565}
virtual VECTOR2D userToDeviceSize(const VECTOR2I &size)
Modify size according to the plotter scale factors (VECTOR2I version, returns a VECTOR2D).
Definition: plotter.cpp:115

References getFillId(), PLOTTER::m_outputFile, SetCurrentLineWidth(), PLOTTER::userToDeviceCoordinates(), PLOTTER::userToDeviceSize(), VECTOR2< T >::x, and VECTOR2< T >::y.

◆ ClearHeaderLinesList()

void PLOTTER::ClearHeaderLinesList ( )
inlineinherited

Remove all lines from the list of free lines to print at the beginning of the file.

Definition at line 176 of file plotter.h.

177 {
178 m_headerExtraLines.Clear();
179 }

References PLOTTER::m_headerExtraLines.

Referenced by GENDRILL_WRITER_BASE::genDrillMapFile(), and StartPlotBoard().

◆ computeTextParameters()

void PSLIKE_PLOTTER::computeTextParameters ( const VECTOR2I aPos,
const wxString &  aText,
const EDA_ANGLE aOrient,
const VECTOR2I aSize,
bool  aMirror,
enum GR_TEXT_H_ALIGN_T  aH_justify,
enum GR_TEXT_V_ALIGN_T  aV_justify,
int  aWidth,
bool  aItalic,
bool  aBold,
double *  wideningFactor,
double *  ctm_a,
double *  ctm_b,
double *  ctm_c,
double *  ctm_d,
double *  ctm_e,
double *  ctm_f,
double *  heightFactor 
)
protectedinherited

This is the core for postscript/PDF text alignment.

It computes the transformation matrix to generate a user space system aligned with the text. Even the PS uses the concat operator to simplify PDF generation (concat is everything PDF has to modify the CTM. Lots of parameters, both in and out.

Definition at line 401 of file PS_plotter.cpp.

419{
420 // Compute the starting position (compensated for alignment)
421 VECTOR2I start_pos = aPos;
422
423 // This is an approximation of the text bounds (in IUs)
424 int tw = returnPostscriptTextWidth( aText, aSize.x, aItalic, aWidth );
425 int th = aSize.y;
426 int dx, dy;
427
428 switch( aH_justify )
429 {
430 case GR_TEXT_H_ALIGN_CENTER: dx = -tw / 2; break;
431 case GR_TEXT_H_ALIGN_RIGHT: dx = -tw; break;
432 case GR_TEXT_H_ALIGN_LEFT: dx = 0; break;
433 }
434
435 switch( aV_justify )
436 {
437 case GR_TEXT_V_ALIGN_CENTER: dy = th / 2; break;
438 case GR_TEXT_V_ALIGN_TOP: dy = th; break;
439 case GR_TEXT_V_ALIGN_BOTTOM: dy = 0; break;
440 }
441
442 RotatePoint( &dx, &dy, aOrient );
443 RotatePoint( &tw, &th, aOrient );
444 start_pos.x += dx;
445 start_pos.y += dy;
446 VECTOR2D pos_dev = userToDeviceCoordinates( start_pos );
447 VECTOR2D sz_dev = userToDeviceSize( aSize );
448
449 // Now returns the final values... the widening factor
450 *wideningFactor = sz_dev.x / sz_dev.y;
451
452 // Mirrored texts must be plotted as mirrored!
453 if( m_plotMirror )
454 *wideningFactor = -*wideningFactor;
455
456 // The CTM transformation matrix
457 double alpha = m_plotMirror ? aOrient.Invert().AsRadians() : aOrient.AsRadians();
458 double sinalpha = sin( alpha );
459 double cosalpha = cos( alpha );
460
461 *ctm_a = cosalpha;
462 *ctm_b = sinalpha;
463 *ctm_c = -sinalpha;
464 *ctm_d = cosalpha;
465 *ctm_e = pos_dev.x;
466 *ctm_f = pos_dev.y;
467
468 // This is because the letters are less than 1 unit high
469 *heightFactor = sz_dev.y / postscriptTextAscent;
470}
EDA_ANGLE Invert() const
Definition: eda_angle.h:201
double AsRadians() const
Definition: eda_angle.h:153
bool m_plotMirror
Definition: plotter.h:627
static const double postscriptTextAscent
Height of the postscript font (from the AFM)
int returnPostscriptTextWidth(const wxString &aText, int aXSize, bool aItalic, bool aBold)
Sister function for the GraphicTextWidth in drawtxt.cpp Does the same processing (i....
Definition: PS_plotter.cpp:329
@ GR_TEXT_H_ALIGN_CENTER
@ GR_TEXT_H_ALIGN_RIGHT
@ GR_TEXT_H_ALIGN_LEFT
@ GR_TEXT_V_ALIGN_BOTTOM
@ GR_TEXT_V_ALIGN_CENTER
@ GR_TEXT_V_ALIGN_TOP
void RotatePoint(int *pX, int *pY, const EDA_ANGLE &aAngle)
Definition: trigo.cpp:183

References EDA_ANGLE::AsRadians(), GR_TEXT_H_ALIGN_CENTER, GR_TEXT_H_ALIGN_LEFT, GR_TEXT_H_ALIGN_RIGHT, GR_TEXT_V_ALIGN_BOTTOM, GR_TEXT_V_ALIGN_CENTER, GR_TEXT_V_ALIGN_TOP, EDA_ANGLE::Invert(), PLOTTER::m_plotMirror, PSLIKE_PLOTTER::postscriptTextAscent, PSLIKE_PLOTTER::returnPostscriptTextWidth(), RotatePoint(), PLOTTER::userToDeviceCoordinates(), PLOTTER::userToDeviceSize(), VECTOR2< T >::x, and VECTOR2< T >::y.

Referenced by PDF_PLOTTER::Text().

◆ emitSetRGBColor()

void PS_PLOTTER::emitSetRGBColor ( double  r,
double  g,
double  b,
double  a 
)
overrideprotectedvirtual

Virtual primitive for emitting the setrgbcolor operator.

Implements PSLIKE_PLOTTER.

Definition at line 493 of file PS_plotter.cpp.

494{
495 wxASSERT( m_outputFile );
496
497 // Postscript treats all colors as opaque, so the best we can do with alpha is generate
498 // an appropriate blended color assuming white paper. (It's possible that a halftone would
499 // work better on *some* drivers, but most drivers are known to still treat halftones as
500 // opaque and remove any colors underneath them.)
501 if( a < 1.0 )
502 {
503 r = ( r * a ) + ( 1 - a );
504 g = ( g * a ) + ( 1 - a );
505 b = ( b * a ) + ( 1 - a );
506 }
507
508 // XXX why %.3g ? shouldn't %g suffice? who cares...
509 fprintf( m_outputFile, "%.3g %.3g %.3g setrgbcolor\n", r, g, b );
510}
E_SERIE r
Definition: eserie.cpp:41

References PLOTTER::m_outputFile, and r.

◆ encodeStringForPlotter()

std::string PSLIKE_PLOTTER::encodeStringForPlotter ( const wxString &  aUnicode)
protectedvirtualinherited

convert a wxString unicode string to a char string compatible with the accepted string plotter format (convert special chars and non ascii7 chars)

Reimplemented in PDF_PLOTTER.

Definition at line 289 of file PS_plotter.cpp.

290{
291 // Write on a std::string a string escaped for postscript/PDF
292 std::string converted;
293
294 converted += '(';
295
296 for( unsigned i = 0; i < aUnicode.Len(); i++ )
297 {
298 // Laziness made me use stdio buffering yet another time...
299 wchar_t ch = aUnicode[i];
300
301 if( ch < 256 )
302 {
303 switch (ch)
304 {
305 // The ~ shouldn't reach the outside
306 case '~':
307 break;
308
309 // These characters must be escaped
310 case '(':
311 case ')':
312 case '\\':
313 converted += '\\';
315
316 default:
317 converted += ch;
318 break;
319 }
320 }
321 }
322
323 converted += ')';
324
325 return converted;
326}
#define KI_FALLTHROUGH
The KI_FALLTHROUGH macro is to be used when switch statement cases should purposely fallthrough from ...
Definition: macros.h:83

References KI_FALLTHROUGH.

Referenced by StartPlot(), and Text().

◆ EndBlock()

virtual void PLOTTER::EndBlock ( void *  aData)
inlinevirtualinherited

calling this function allows one to define the end of a group of drawing items for instance in SVG or Gerber format.

the group is started by StartBlock()

Parameters
aDatacan define any parameter for most of plotters: do nothing

Reimplemented in GERBER_PLOTTER, and SVG_PLOTTER.

Definition at line 527 of file plotter.h.

527{}

Referenced by SCH_SYMBOL::Plot(), BRDITEMS_PLOTTER::PlotFilledAreas(), and PlotStandardLayer().

◆ EndPlot()

bool PS_PLOTTER::EndPlot ( )
overridevirtual

Implements PLOTTER.

Definition at line 926 of file PS_plotter.cpp.

927{
928 wxASSERT( m_outputFile );
929 fputs( "showpage\n"
930 "grestore\n"
931 "%%EOF\n", m_outputFile );
932 fclose( m_outputFile );
933 m_outputFile = nullptr;
934
935 return true;
936}

References PLOTTER::m_outputFile.

Referenced by SCH_PLOTTER::plotOneSheetPS().

◆ FilledCircle()

void PLOTTER::FilledCircle ( const VECTOR2I pos,
int  diametre,
OUTLINE_MODE  tracemode,
void *  aData 
)
virtualinherited

Reimplemented in GERBER_PLOTTER.

Definition at line 668 of file plotter.cpp.

669{
670 if( tracemode == FILLED )
671 {
672 Circle( pos, diametre, FILL_T::FILLED_SHAPE, 0 );
673 }
674 else
675 {
677 Circle( pos, diametre, FILL_T::NO_FILL, -1 );
678 }
679}
virtual void Circle(const VECTOR2I &pos, int diametre, FILL_T fill, int width=USE_DEFAULT_LINE_WIDTH)=0
@ FILLED_SHAPE
@ FILLED
Definition: outline_mode.h:27

References PLOTTER::Circle(), FILLED, FILLED_SHAPE, NO_FILL, and PLOTTER::SetCurrentLineWidth().

Referenced by BRDITEMS_PLOTTER::PlotFootprintShape(), and BRDITEMS_PLOTTER::PlotPcbShape().

◆ FinishTo()

◆ FlashPadCircle()

void PSLIKE_PLOTTER::FlashPadCircle ( const VECTOR2I aPadPos,
int  aDiameter,
OUTLINE_MODE  aTraceMode,
void *  aData 
)
overridevirtualinherited
Parameters
aPadPosPosition of the shape (center of the rectangle.
aDiameteris the diameter of round pad.
aTraceModeis the drawing mode, FILLED or SKETCH.
aDatais an auxiliary info (mainly for gerber format attributes).

Implements PLOTTER.

Definition at line 120 of file PS_plotter.cpp.

122{
123 if( aTraceMode == FILLED )
124 {
125 Circle( aPadPos, aDiameter, FILL_T::FILLED_SHAPE, 0 );
126 }
127 else // Plot a ring:
128 {
130 Circle( aPadPos, aDiameter, FILL_T::NO_FILL, GetCurrentLineWidth() );
131 }
132
134}
static const int USE_DEFAULT_LINE_WIDTH
Definition: plotter.h:114
virtual int GetCurrentLineWidth() const
Definition: plotter.h:153

References PLOTTER::Circle(), FILLED, FILLED_SHAPE, PLOTTER::GetCurrentLineWidth(), NO_FILL, PLOTTER::SetCurrentLineWidth(), and PLOTTER::USE_DEFAULT_LINE_WIDTH.

◆ FlashPadCustom()

void PSLIKE_PLOTTER::FlashPadCustom ( const VECTOR2I aPadPos,
const VECTOR2I aSize,
const EDA_ANGLE aPadOrient,
SHAPE_POLY_SET aPolygons,
OUTLINE_MODE  aTraceMode,
void *  aData 
)
overridevirtualinherited
Parameters
aPadPosPosition of the shape.
aSizeis the size of round reference pad.
aPadOrientis the pad rotation, used only with aperture macros (Gerber plotter).
aPolygonsthe shape as polygon set.
aTraceModeis the drawing mode, FILLED or SKETCH.
aDataan auxiliary info (mainly for gerber format attributes).

Implements PLOTTER.

Definition at line 214 of file PS_plotter.cpp.

217{
218 VECTOR2I size( aSize );
219
220 if( aTraceMode == FILLED )
221 {
223 }
224 else
225 {
227 }
228
229
230 std::vector<VECTOR2I> cornerList;
231
232 for( int cnt = 0; cnt < aPolygons->OutlineCount(); ++cnt )
233 {
234 SHAPE_LINE_CHAIN& poly = aPolygons->Outline( cnt );
235 cornerList.clear();
236
237 for( int ii = 0; ii < poly.PointCount(); ++ii )
238 cornerList.emplace_back( poly.CPoint( ii ).x, poly.CPoint( ii ).y );
239
240 // Close polygon
241 cornerList.push_back( cornerList[0] );
242
243 PlotPoly( cornerList, ( aTraceMode == FILLED ) ? FILL_T::FILLED_SHAPE : FILL_T::NO_FILL,
245 }
246}
virtual void PlotPoly(const std::vector< VECTOR2I > &aCornerList, FILL_T aFill, int aWidth=USE_DEFAULT_LINE_WIDTH, void *aData=nullptr)=0
Draw a polygon ( filled or not ).
Represent a polyline containing arcs as well as line segments: A chain of connected line and/or arc s...
int PointCount() const
Return the number of points (vertices) in this line chain.
const VECTOR2I & CPoint(int aIndex) const
Return a reference to a given point in the line chain.
SHAPE_LINE_CHAIN & Outline(int aIndex)
int OutlineCount() const
Return the number of vertices in a given outline/hole.

References SHAPE_LINE_CHAIN::CPoint(), FILLED, FILLED_SHAPE, PLOTTER::GetCurrentLineWidth(), NO_FILL, SHAPE_POLY_SET::Outline(), SHAPE_POLY_SET::OutlineCount(), PLOTTER::PlotPoly(), SHAPE_LINE_CHAIN::PointCount(), PLOTTER::SetCurrentLineWidth(), PLOTTER::USE_DEFAULT_LINE_WIDTH, VECTOR2< T >::x, and VECTOR2< T >::y.

◆ FlashPadOval()

void PSLIKE_PLOTTER::FlashPadOval ( const VECTOR2I aPadPos,
const VECTOR2I aSize,
const EDA_ANGLE aPadOrient,
OUTLINE_MODE  aTraceMode,
void *  aData 
)
overridevirtualinherited
Parameters
aPadPosPosition of the shape (center of the rectangle.
aSizeis the size of oblong shape.
aPadOrientThe rotation of the shape.
aTraceModeis the drawing mode, FILLED or SKETCH.
aDataan auxiliary info (mainly for gerber format attributes).

Implements PLOTTER.

Definition at line 90 of file PS_plotter.cpp.

93{
94 wxASSERT( m_outputFile );
95
96 VECTOR2I size( aSize );
97 EDA_ANGLE orient( aPadOrient );
98
99 // The pad is reduced to an oval by dy > dx
100 if( size.x > size.y )
101 {
102 std::swap( size.x, size.y );
103 orient += ANGLE_90;
104 }
105
106 int delta = size.y - size.x;
107 VECTOR2I a( 0, -delta / 2 );
108 VECTOR2I b( 0, delta / 2 );
109
110 RotatePoint( a, orient );
111 RotatePoint( b, orient );
112
113 if( aTraceMode == FILLED )
114 ThickSegment( a + aPadPos, b + aPadPos, size.x, aTraceMode, nullptr );
115 else
116 sketchOval( aPadPos, size, orient, -1 );
117}
virtual void ThickSegment(const VECTOR2I &start, const VECTOR2I &end, int width, OUTLINE_MODE tracemode, void *aData)
Definition: plotter.cpp:549
void sketchOval(const VECTOR2I &aPos, const VECTOR2I &aSize, const EDA_ANGLE &aOrient, int aWidth)
Definition: plotter.cpp:496
static constexpr EDA_ANGLE & ANGLE_90
Definition: eda_angle.h:414

References ANGLE_90, delta, FILLED, PLOTTER::m_outputFile, RotatePoint(), PLOTTER::sketchOval(), PLOTTER::ThickSegment(), VECTOR2< T >::x, and VECTOR2< T >::y.

◆ FlashPadRect()

void PSLIKE_PLOTTER::FlashPadRect ( const VECTOR2I aPadPos,
const VECTOR2I aSize,
const EDA_ANGLE aPadOrient,
OUTLINE_MODE  aTraceMode,
void *  aData 
)
overridevirtualinherited
Parameters
aPadPosPosition of the shape (center of the rectangle).
aSizeis the size of rounded rect.
aPadOrientThe rotation of the shape.
aTraceModeis the drawing mode, FILLED or SKETCH.
aDataan auxiliary info (mainly for gerber format attributes).

Implements PLOTTER.

Definition at line 137 of file PS_plotter.cpp.

140{
141 std::vector<VECTOR2I> cornerList;
142 VECTOR2I size( aSize );
143 cornerList.reserve( 4 );
144
145 if( aTraceMode == FILLED )
147 else
149
150 int dx = size.x / 2;
151 int dy = size.y / 2;
152
153 VECTOR2I corner;
154 corner.x = aPadPos.x - dx;
155 corner.y = aPadPos.y + dy;
156 cornerList.push_back( corner );
157 corner.x = aPadPos.x - dx;
158 corner.y = aPadPos.y - dy;
159 cornerList.push_back( corner );
160 corner.x = aPadPos.x + dx;
161 corner.y = aPadPos.y - dy;
162 cornerList.push_back( corner );
163 corner.x = aPadPos.x + dx;
164 corner.y = aPadPos.y + dy,
165 cornerList.push_back( corner );
166
167 for( unsigned ii = 0; ii < cornerList.size(); ii++ )
168 RotatePoint( cornerList[ii], aPadPos, aPadOrient );
169
170 cornerList.push_back( cornerList[0] );
171
172 PlotPoly( cornerList, ( aTraceMode == FILLED ) ? FILL_T::FILLED_SHAPE : FILL_T::NO_FILL,
174}

References FILLED, FILLED_SHAPE, PLOTTER::GetCurrentLineWidth(), NO_FILL, PLOTTER::PlotPoly(), RotatePoint(), PLOTTER::SetCurrentLineWidth(), PLOTTER::USE_DEFAULT_LINE_WIDTH, VECTOR2< T >::x, and VECTOR2< T >::y.

◆ FlashPadRoundRect()

void PSLIKE_PLOTTER::FlashPadRoundRect ( const VECTOR2I aPadPos,
const VECTOR2I aSize,
int  aCornerRadius,
const EDA_ANGLE aOrient,
OUTLINE_MODE  aTraceMode,
void *  aData 
)
overridevirtualinherited
Parameters
aPadPosPosition of the shape (center of the rectangle.
aSizeis the size of rounded rect.
aCornerRadiusRadius of the rounded corners.
aOrientThe rotation of the shape.
aTraceModeis the drawing mode, FILLED or SKETCH.
aDataan auxiliary info (mainly for gerber format attributes).

Implements PLOTTER.

Definition at line 177 of file PS_plotter.cpp.

180{
181 VECTOR2I size( aSize );
182
183 if( aTraceMode == FILLED )
184 {
186 }
187 else
188 {
190 }
191
192
193 SHAPE_POLY_SET outline;
194 TransformRoundChamferedRectToPolygon( outline, aPadPos, size, aOrient, aCornerRadius, 0.0, 0,
196
197 std::vector<VECTOR2I> cornerList;
198
199 // TransformRoundRectToPolygon creates only one convex polygon
200 SHAPE_LINE_CHAIN& poly = outline.Outline( 0 );
201 cornerList.reserve( poly.PointCount() );
202
203 for( int ii = 0; ii < poly.PointCount(); ++ii )
204 cornerList.emplace_back( poly.CPoint( ii ).x, poly.CPoint( ii ).y );
205
206 // Close polygon
207 cornerList.push_back( cornerList[0] );
208
209 PlotPoly( cornerList, ( aTraceMode == FILLED ) ? FILL_T::FILLED_SHAPE : FILL_T::NO_FILL,
211}
int GetPlotterArcHighDef() const
Definition: plotter.h:213
Represent a set of closed polygons.
void TransformRoundChamferedRectToPolygon(SHAPE_POLY_SET &aBuffer, const VECTOR2I &aPosition, const VECTOR2I &aSize, const EDA_ANGLE &aRotation, int aCornerRadius, double aChamferRatio, int aChamferCorners, int aInflate, int aError, ERROR_LOC aErrorLoc)
Convert a rectangle with rounded corners and/or chamfered corners to a polygon.
@ ERROR_INSIDE

References SHAPE_LINE_CHAIN::CPoint(), ERROR_INSIDE, FILLED, FILLED_SHAPE, PLOTTER::GetCurrentLineWidth(), PLOTTER::GetPlotterArcHighDef(), NO_FILL, SHAPE_POLY_SET::Outline(), PLOTTER::PlotPoly(), SHAPE_LINE_CHAIN::PointCount(), PLOTTER::SetCurrentLineWidth(), TransformRoundChamferedRectToPolygon(), PLOTTER::USE_DEFAULT_LINE_WIDTH, VECTOR2< T >::x, and VECTOR2< T >::y.

◆ FlashPadTrapez()

void PSLIKE_PLOTTER::FlashPadTrapez ( const VECTOR2I aPadPos,
const VECTOR2I aCorners,
const EDA_ANGLE aPadOrient,
OUTLINE_MODE  aTraceMode,
void *  aData 
)
overridevirtualinherited

Flash a trapezoidal pad.

Parameters
aPadPosis the the position of the shape.
aCornersis the list of 4 corners positions, relative to the shape position, pad orientation 0.
aPadOrientis the rotation of the shape.
aTraceModeis the drawing mode, FILLED or SKETCH.
aDataan auxiliary info (mainly for gerber format attributes).

Implements PLOTTER.

Definition at line 249 of file PS_plotter.cpp.

252{
253 static std::vector<VECTOR2I> cornerList;
254 cornerList.clear();
255
256 for( int ii = 0; ii < 4; ii++ )
257 cornerList.push_back( aCorners[ii] );
258
259 if( aTraceMode == FILLED )
260 {
262 }
263 else
264 {
266 }
267
268 for( int ii = 0; ii < 4; ii++ )
269 {
270 RotatePoint( cornerList[ii], aPadOrient );
271 cornerList[ii] += aPadPos;
272 }
273
274 cornerList.push_back( cornerList[0] );
275 PlotPoly( cornerList, ( aTraceMode == FILLED ) ? FILL_T::FILLED_SHAPE : FILL_T::NO_FILL,
277}

References FILLED, FILLED_SHAPE, PLOTTER::GetCurrentLineWidth(), NO_FILL, PLOTTER::PlotPoly(), RotatePoint(), PLOTTER::SetCurrentLineWidth(), and PLOTTER::USE_DEFAULT_LINE_WIDTH.

◆ FlashRegularPolygon()

void PSLIKE_PLOTTER::FlashRegularPolygon ( const VECTOR2I aShapePos,
int  aDiameter,
int  aCornerCount,
const EDA_ANGLE aOrient,
OUTLINE_MODE  aTraceMode,
void *  aData 
)
overridevirtualinherited

Flash a regular polygon.

Useful only in Gerber files to flash a regular polygon.

Parameters
aShapePosis the center of the circle containing the polygon.
aRadiusis the radius of the circle containing the polygon.
aCornerCountis the number of vertices.
aOrientis the polygon rotation.
aDatais a auxiliary parameter used (if needed) to handle extra info specific to the plotter.

Implements PLOTTER.

Definition at line 280 of file PS_plotter.cpp.

283{
284 // Do nothing
285 wxASSERT( 0 );
286}

◆ GetColorMode()

◆ GetCurrentLineWidth()

◆ GetDashGapLenIU()

double PLOTTER::GetDashGapLenIU ( int  aLineWidth) const
protectedinherited

Definition at line 143 of file plotter.cpp.

144{
145 return userToDeviceSize( m_renderSettings->GetGapLength( aLineWidth ) );
146}
double GetGapLength(int aLineWidth) const
RENDER_SETTINGS * m_renderSettings
Definition: plotter.h:650

References KIGFX::RENDER_SETTINGS::GetGapLength(), PLOTTER::m_renderSettings, and PLOTTER::userToDeviceSize().

Referenced by SetDash(), PDF_PLOTTER::SetDash(), and SVG_PLOTTER::setSVGPlotStyle().

◆ GetDashMarkLenIU()

double PLOTTER::GetDashMarkLenIU ( int  aLineWidth) const
protectedinherited

◆ GetDefaultFileExtension()

static wxString PS_PLOTTER::GetDefaultFileExtension ( )
inlinestatic

Definition at line 165 of file plotters_pslike.h.

166 {
167 return wxString( wxT( "ps" ) );
168 }

Referenced by SCH_PLOTTER::createPSFiles(), and GetDefaultPlotExtension().

◆ GetDotMarkLenIU()

double PLOTTER::GetDotMarkLenIU ( int  aLineWidth) const
protectedinherited

◆ GetIUsPerDecimil()

double PLOTTER::GetIUsPerDecimil ( ) const
inlineinherited

The IUs per decimil are an essential scaling factor when plotting; they are set and saved when establishing the viewport.

Here they can be get back again

Definition at line 210 of file plotter.h.

210{ return m_IUsPerDecimil; }
double m_IUsPerDecimil
Definition: plotter.h:622

References PLOTTER::m_IUsPerDecimil.

Referenced by PlotDrawingSheet().

◆ GetPlotterArcHighDef()

◆ GetPlotterArcLowDef()

int PLOTTER::GetPlotterArcLowDef ( ) const
inlineinherited

Definition at line 212 of file plotter.h.

212{ return m_IUsPerDecimil * 8; }

References PLOTTER::m_IUsPerDecimil.

◆ GetPlotterType()

virtual PLOT_FORMAT PS_PLOTTER::GetPlotterType ( ) const
inlineoverridevirtual

Returns the effective plot engine in use.

It's not very OO but for now is required since some things are only done with some output devices (like drill marks, emitted only for postscript

Implements PLOTTER.

Definition at line 170 of file plotters_pslike.h.

171 {
172 return PLOT_FORMAT::POST;
173 }

References POST.

◆ HyperlinkBox()

virtual void PLOTTER::HyperlinkBox ( const BOX2I aBox,
const wxString &  aDestinationURL 
)
inlinevirtualinherited

Create a clickable hyperlink with a rectangular click area.

@aBox is the rectangular click target @aDestinationURL is the target URL

Reimplemented in PDF_PLOTTER.

Definition at line 435 of file plotter.h.

436 {
437 // NOP for most plotters.
438 }

Referenced by SCH_TEXT::Plot(), and SCH_TEXTBOX::Plot().

◆ HyperlinkMenu()

virtual void PLOTTER::HyperlinkMenu ( const BOX2I aBox,
const std::vector< wxString > &  aDestURLs 
)
inlinevirtualinherited

Create a clickable hyperlink menu with a rectangular click area.

@aBox is the rectangular click target @aDestURLs is the list of target URLs for the menu

Reimplemented in PDF_PLOTTER.

Definition at line 446 of file plotter.h.

447 {
448 // NOP for most plotters.
449 }

Referenced by SCH_FIELD::Plot(), SCH_LABEL_BASE::Plot(), SCH_LINE::Plot(), SCH_SHEET::Plot(), SCH_SYMBOL::Plot(), and PlotInteractiveLayer().

◆ LineTo()

◆ Marker()

void PLOTTER::Marker ( const VECTOR2I position,
int  diametre,
unsigned  aShapeId 
)
inherited

Draw a pattern shape number aShapeId, to coord position.

Parameters
aPositionis the position of the marker.
aDiameteris the diameter of the marker.
aShapeIdis the index (used to generate forms characters).

Definition at line 359 of file plotter.cpp.

360{
361 int radius = diametre / 2;
362
363 /* Marker are composed by a series of 'parts' superimposed; not every
364 combination make sense, obviously. Since they are used in order I
365 tried to keep the uglier/more complex constructions at the end.
366 Also I avoided the |/ |\ -/ -\ construction because they're *very*
367 ugly... if needed they could be added anyway... I'd like to see
368 a board with more than 58 drilling/slotting tools!
369 If Visual C++ supported the 0b literals they would be optimally
370 and easily encoded as an integer array. We have to do with octal */
371 static const unsigned char marker_patterns[MARKER_COUNT] = {
372
373 // Bit order: O Square Lozenge - | \ /
374 // First choice: simple shapes
375 0003, // X
376 0100, // O
377 0014, // +
378 0040, // Sq
379 0020, // Lz
380
381 // Two simple shapes
382 0103, // X O
383 0017, // X +
384 0043, // X Sq
385 0023, // X Lz
386 0114, // O +
387 0140, // O Sq
388 0120, // O Lz
389 0054, // + Sq
390 0034, // + Lz
391 0060, // Sq Lz
392
393 // Three simple shapes
394 0117, // X O +
395 0143, // X O Sq
396 0123, // X O Lz
397 0057, // X + Sq
398 0037, // X + Lz
399 0063, // X Sq Lz
400 0154, // O + Sq
401 0134, // O + Lz
402 0074, // + Sq Lz
403
404 // Four simple shapes
405 0174, // O Sq Lz +
406 0163, // X O Sq Lz
407 0157, // X O Sq +
408 0137, // X O Lz +
409 0077, // X Sq Lz +
410
411 // This draws *everything *
412 0177, // X O Sq Lz +
413
414 // Here we use the single bars... so the cross is forbidden
415 0110, // O -
416 0104, // O |
417 0101, // O /
418 0050, // Sq -
419 0044, // Sq |
420 0041, // Sq /
421 0030, // Lz -
422 0024, // Lz |
423 0021, // Lz /
424 0150, // O Sq -
425 0144, // O Sq |
426 0141, // O Sq /
427 0130, // O Lz -
428 0124, // O Lz |
429 0121, // O Lz /
430 0070, // Sq Lz -
431 0064, // Sq Lz |
432 0061, // Sq Lz /
433 0170, // O Sq Lz -
434 0164, // O Sq Lz |
435 0161, // O Sq Lz /
436
437 // Last resort: the backlash component (easy to confound)
438 0102, // \ O
439 0042, // \ Sq
440 0022, // \ Lz
441 0142, // \ O Sq
442 0122, // \ O Lz
443 0062, // \ Sq Lz
444 0162 // \ O Sq Lz
445 };
446
447 if( aShapeId >= MARKER_COUNT )
448 {
449 // Fallback shape
450 markerCircle( position, radius );
451 }
452 else
453 {
454 // Decode the pattern and draw the corresponding parts
455 unsigned char pat = marker_patterns[aShapeId];
456
457 if( pat & 0001 )
458 markerSlash( position, radius );
459
460 if( pat & 0002 )
461 markerBackSlash( position, radius );
462
463 if( pat & 0004 )
464 markerVBar( position, radius );
465
466 if( pat & 0010 )
467 markerHBar( position, radius );
468
469 if( pat & 0020 )
470 markerLozenge( position, radius );
471
472 if( pat & 0040 )
473 markerSquare( position, radius );
474
475 if( pat & 0100 )
476 markerCircle( position, radius );
477 }
478}
static const unsigned MARKER_COUNT
Draw a marker (used for the drill map).
Definition: plotter.h:466
void markerSlash(const VECTOR2I &pos, int radius)
Plot a / bar centered on the position.
Definition: plotter.cpp:338
void markerHBar(const VECTOR2I &pos, int radius)
Plot a - bar centered on the position.
Definition: plotter.cpp:331
void markerCircle(const VECTOR2I &pos, int radius)
Plot a circle centered on the position.
Definition: plotter.cpp:298
void markerLozenge(const VECTOR2I &position, int radius)
Plot a lozenge centered on the position.
Definition: plotter.cpp:304
void markerBackSlash(const VECTOR2I &pos, int radius)
Plot a \ bar centered on the position.
Definition: plotter.cpp:345
void markerVBar(const VECTOR2I &pos, int radius)
Plot a | bar centered on the position.
Definition: plotter.cpp:352
void markerSquare(const VECTOR2I &position, int radius)
Plot a square centered on the position.
Definition: plotter.cpp:270

References PLOTTER::MARKER_COUNT, PLOTTER::markerBackSlash(), PLOTTER::markerCircle(), PLOTTER::markerHBar(), PLOTTER::markerLozenge(), PLOTTER::markerSlash(), PLOTTER::markerSquare(), and PLOTTER::markerVBar().

Referenced by GENDRILL_WRITER_BASE::genDrillMapFile(), and GENDRILL_WRITER_BASE::plotDrillMarks().

◆ markerBackSlash()

void PLOTTER::markerBackSlash ( const VECTOR2I pos,
int  radius 
)
protectedinherited

Plot a \ bar centered on the position.

Building block for markers

Definition at line 345 of file plotter.cpp.

346{
347 MoveTo( VECTOR2I( pos.x + radius, pos.y - radius ) );
348 FinishTo( VECTOR2I( pos.x - radius, pos.y + radius ) );
349}
VECTOR2< int > VECTOR2I
Definition: vector2d.h:618

References PLOTTER::FinishTo(), PLOTTER::MoveTo(), VECTOR2< T >::x, and VECTOR2< T >::y.

Referenced by PLOTTER::Marker().

◆ markerCircle()

void PLOTTER::markerCircle ( const VECTOR2I pos,
int  radius 
)
protectedinherited

Plot a circle centered on the position.

Building block for markers

Definition at line 298 of file plotter.cpp.

299{
300 Circle( position, radius * 2, FILL_T::NO_FILL, GetCurrentLineWidth() );
301}

References PLOTTER::Circle(), PLOTTER::GetCurrentLineWidth(), and NO_FILL.

Referenced by PLOTTER::Marker().

◆ markerHBar()

void PLOTTER::markerHBar ( const VECTOR2I pos,
int  radius 
)
protectedinherited

Plot a - bar centered on the position.

Building block for markers

Definition at line 331 of file plotter.cpp.

332{
333 MoveTo( VECTOR2I( pos.x - radius, pos.y ) );
334 FinishTo( VECTOR2I( pos.x + radius, pos.y ) );
335}

References PLOTTER::FinishTo(), PLOTTER::MoveTo(), VECTOR2< T >::x, and VECTOR2< T >::y.

Referenced by PLOTTER::Marker().

◆ markerLozenge()

void PLOTTER::markerLozenge ( const VECTOR2I position,
int  radius 
)
protectedinherited

Plot a lozenge centered on the position.

Building block for markers

Definition at line 304 of file plotter.cpp.

305{
306 std::vector<VECTOR2I> corner_list;
307 VECTOR2I corner;
308
309 corner_list.reserve( 4 );
310
311 corner.x = position.x;
312 corner.y = position.y + radius;
313 corner_list.push_back( corner );
314 corner.x = position.x + radius;
315 corner.y = position.y,
316 corner_list.push_back( corner );
317 corner.x = position.x;
318 corner.y = position.y - radius;
319 corner_list.push_back( corner );
320 corner.x = position.x - radius;
321 corner.y = position.y;
322 corner_list.push_back( corner );
323 corner.x = position.x;
324 corner.y = position.y + radius;
325 corner_list.push_back( corner );
326
328}

References PLOTTER::GetCurrentLineWidth(), NO_FILL, PLOTTER::PlotPoly(), VECTOR2< T >::x, and VECTOR2< T >::y.

Referenced by PLOTTER::Marker().

◆ markerSlash()

void PLOTTER::markerSlash ( const VECTOR2I pos,
int  radius 
)
protectedinherited

Plot a / bar centered on the position.

Building block for markers

Definition at line 338 of file plotter.cpp.

339{
340 MoveTo( VECTOR2I( pos.x - radius, pos.y - radius ) );
341 FinishTo( VECTOR2I( pos.x + radius, pos.y + radius ) );
342}

References PLOTTER::FinishTo(), PLOTTER::MoveTo(), VECTOR2< T >::x, and VECTOR2< T >::y.

Referenced by PLOTTER::Marker().

◆ markerSquare()

void PLOTTER::markerSquare ( const VECTOR2I position,
int  radius 
)
protectedinherited

Plot a square centered on the position.

Building block for markers

Definition at line 270 of file plotter.cpp.

271{
272 double r = KiROUND( radius / 1.4142 );
273 std::vector<VECTOR2I> corner_list;
274 VECTOR2I corner;
275
276 corner_list.reserve( 4 );
277
278 corner.x = position.x + r;
279 corner.y = position.y + r;
280 corner_list.push_back( corner );
281 corner.x = position.x + r;
282 corner.y = position.y - r;
283 corner_list.push_back( corner );
284 corner.x = position.x - r;
285 corner.y = position.y - r;
286 corner_list.push_back( corner );
287 corner.x = position.x - r;
288 corner.y = position.y + r;
289 corner_list.push_back( corner );
290 corner.x = position.x + r;
291 corner.y = position.y + r;
292 corner_list.push_back( corner );
293
295}

References PLOTTER::GetCurrentLineWidth(), KiROUND(), NO_FILL, PLOTTER::PlotPoly(), r, VECTOR2< T >::x, and VECTOR2< T >::y.

Referenced by PLOTTER::Marker().

◆ markerVBar()

void PLOTTER::markerVBar ( const VECTOR2I pos,
int  radius 
)
protectedinherited

Plot a | bar centered on the position.

Building block for markers

Definition at line 352 of file plotter.cpp.

353{
354 MoveTo( VECTOR2I( pos.x, pos.y - radius ) );
355 FinishTo( VECTOR2I( pos.x, pos.y + radius ) );
356}

References PLOTTER::FinishTo(), PLOTTER::MoveTo(), VECTOR2< T >::x, and VECTOR2< T >::y.

Referenced by PLOTTER::Marker().

◆ MoveTo()

◆ OpenFile()

bool PLOTTER::OpenFile ( const wxString &  aFullFilename)
virtualinherited

Open or create the plot file aFullFilename.

Parameters
aFullFilenameis the full file name of the file to create.
Returns
true if success, false if the file cannot be created/opened.

Virtual because some plotters use ascii files, some others binary files (PDF) The base class open the file in text mode

Reimplemented in PDF_PLOTTER.

Definition at line 74 of file plotter.cpp.

75{
76 m_filename = aFullFilename;
77
78 wxASSERT( !m_outputFile );
79
80 // Open the file in text mode (not suitable for all plotters but only for most of them.
81 m_outputFile = wxFopen( m_filename, wxT( "wt" ) );
82
83 if( m_outputFile == nullptr )
84 return false ;
85
86 return true;
87}
wxString m_filename
Definition: plotter.h:643

References PLOTTER::m_filename, and PLOTTER::m_outputFile.

Referenced by GERBER_WRITER::createDrillFile(), PLACEFILE_GERBER_WRITER::CreatePlaceFile(), GENDRILL_WRITER_BASE::genDrillMapFile(), SCH_PLOTTER::plotOneSheetDXF(), SCH_PLOTTER::plotOneSheetHpgl(), SCH_PLOTTER::plotOneSheetPS(), SCH_PLOTTER::plotOneSheetSVG(), StartPlotBoard(), and SYMBOL_EDIT_FRAME::SVGPlotSymbol().

◆ PageSettings()

PAGE_INFO & PLOTTER::PageSettings ( )
inlineinherited

Definition at line 144 of file plotter.h.

144{ return m_pageInfo; }
PAGE_INFO m_pageInfo
Definition: plotter.h:645

References PLOTTER::m_pageInfo.

Referenced by SCH_PLOTTER::plotOneSheetPDF(), SCH_PLOTTER::plotOneSheetPS(), and SCH_PLOTTER::plotOneSheetSVG().

◆ PenFinish()

void PLOTTER::PenFinish ( )
inlineinherited

Definition at line 263 of file plotter.h.

264 {
265 // The point is not important with Z motion
266 PenTo( VECTOR2I( 0, 0 ), 'Z' );
267 }

References PLOTTER::PenTo().

Referenced by HPGL_PLOTTER::Circle(), HPGL_PLOTTER::FlashPadCircle(), GERBER_PLOTTER::PlotPoly(), DXF_PLOTTER::PlotPoly(), HPGL_PLOTTER::PlotPoly(), HPGL_PLOTTER::Rect(), and PLOTTER::Text().

◆ PenTo()

void PS_PLOTTER::PenTo ( const VECTOR2I pos,
char  plume 
)
overridevirtual

Moveto/lineto primitive, moves the 'pen' to the specified direction.

Parameters
posis the target position.
plumespecifies the kind of motion: 'U' only moves the pen, 'D' draw a line from the current position and 'Z' finish the drawing and returns the 'pen' to rest (flushes the trace).

Implements PLOTTER.

Definition at line 730 of file PS_plotter.cpp.

731{
732 wxASSERT( m_outputFile );
733
734 if( plume == 'Z' )
735 {
736 if( m_penState != 'Z' )
737 {
738 fputs( "stroke\n", m_outputFile );
739 m_penState = 'Z';
740 m_penLastpos.x = -1;
741 m_penLastpos.y = -1;
742 }
743
744 return;
745 }
746
747 if( m_penState == 'Z' )
748 {
749 fputs( "newpath\n", m_outputFile );
750 }
751
752 if( m_penState != plume || pos != m_penLastpos )
753 {
754 VECTOR2D pos_dev = userToDeviceCoordinates( pos );
755 fprintf( m_outputFile, "%g %g %sto\n",
756 pos_dev.x, pos_dev.y,
757 ( plume=='D' ) ? "line" : "move" );
758 }
759
760 m_penState = plume;
761 m_penLastpos = pos;
762}
VECTOR2I m_penLastpos
Definition: plotter.h:640
char m_penState
Definition: plotter.h:639

References PLOTTER::m_outputFile, PLOTTER::m_penLastpos, PLOTTER::m_penState, PLOTTER::userToDeviceCoordinates(), VECTOR2< T >::x, and VECTOR2< T >::y.

◆ PlotImage()

void PS_PLOTTER::PlotImage ( const wxImage &  aImage,
const VECTOR2I aPos,
double  aScaleFactor 
)
overridevirtual

PostScript-likes at the moment are the only plot engines supporting bitmaps.

Reimplemented from PLOTTER.

Definition at line 622 of file PS_plotter.cpp.

623{
624 VECTOR2I pix_size; // size of the bitmap in pixels
625 pix_size.x = aImage.GetWidth();
626 pix_size.y = aImage.GetHeight();
627 VECTOR2D drawsize( aScaleFactor * pix_size.x,
628 aScaleFactor * pix_size.y ); // requested size of image
629
630 // calculate the bottom left corner position of bitmap
631 VECTOR2I start = aPos;
632 start.x -= drawsize.x / 2; // left
633 start.y += drawsize.y / 2; // bottom (Y axis reversed)
634
635 // calculate the top right corner position of bitmap
636 VECTOR2I end;
637 end.x = start.x + drawsize.x;
638 end.y = start.y - drawsize.y;
639
640 fprintf( m_outputFile, "/origstate save def\n" );
641 fprintf( m_outputFile, "/pix %d string def\n", pix_size.x );
642
643 // Locate lower-left corner of image
644 VECTOR2D start_dev = userToDeviceCoordinates( start );
645 fprintf( m_outputFile, "%g %g translate\n", start_dev.x, start_dev.y );
646
647 // Map image size to device
648 VECTOR2D end_dev = userToDeviceCoordinates( end );
649 fprintf( m_outputFile, "%g %g scale\n",
650 std::abs( end_dev.x - start_dev.x ),
651 std::abs( end_dev.y - start_dev.y ) );
652
653 // Dimensions of source image (in pixels
654 fprintf( m_outputFile, "%d %d 8", pix_size.x, pix_size.y );
655
656 // Map unit square to source
657 fprintf( m_outputFile, " [%d 0 0 %d 0 %d]\n", pix_size.x, -pix_size.y , pix_size.y);
658
659 // include image data in ps file
660 fprintf( m_outputFile, "{currentfile pix readhexstring pop}\n" );
661
662 if( m_colorMode )
663 fputs( "false 3 colorimage\n", m_outputFile );
664 else
665 fputs( "image\n", m_outputFile );
666
667 // Single data source, 3 colors, Output RGB data (hexadecimal)
668 // (or the same downscaled to gray)
669 int jj = 0;
670
671 for( int yy = 0; yy < pix_size.y; yy ++ )
672 {
673 for( int xx = 0; xx < pix_size.x; xx++, jj++ )
674 {
675 if( jj >= 16 )
676 {
677 jj = 0;
678 fprintf( m_outputFile, "\n");
679 }
680
681 int red, green, blue;
682 red = aImage.GetRed( xx, yy) & 0xFF;
683 green = aImage.GetGreen( xx, yy) & 0xFF;
684 blue = aImage.GetBlue( xx, yy) & 0xFF;
685
686 // PS doesn't support alpha, so premultiply against white background
687 if( aImage.HasAlpha() )
688 {
689 unsigned char alpha = aImage.GetAlpha( xx, yy ) & 0xFF;
690
691 if( alpha < 0xFF )
692 {
693 float a = 1.0 - ( (float) alpha / 255.0 );
694 red = ( int )( red + ( a * 0xFF ) ) & 0xFF;
695 green = ( int )( green + ( a * 0xFF ) ) & 0xFF;
696 blue = ( int )( blue + ( a * 0xFF ) ) & 0xFF;
697 }
698 }
699
700 if( aImage.HasMask() )
701 {
702 if( red == aImage.GetMaskRed() && green == aImage.GetMaskGreen()
703 && blue == aImage.GetMaskBlue() )
704 {
705 red = 0xFF;
706 green = 0xFF;
707 blue = 0xFF;
708 }
709 }
710
711 if( m_colorMode )
712 {
713 fprintf( m_outputFile, "%2.2X%2.2X%2.2X", red, green, blue );
714 }
715 else
716 {
717 // Greyscale conversion (CIE 1931)
718 unsigned char grey = KiROUND( red * 0.2126 + green * 0.7152 + blue * 0.0722 );
719
720 fprintf( m_outputFile, "%2.2X", grey );
721 }
722 }
723 }
724
725 fprintf( m_outputFile, "\n");
726 fprintf( m_outputFile, "origstate restore\n" );
727}
EDA_ANGLE abs(const EDA_ANGLE &aAngle)
Definition: eda_angle.h:401

References std::abs(), KiROUND(), PLOTTER::m_colorMode, PLOTTER::m_outputFile, red, PLOTTER::userToDeviceCoordinates(), VECTOR2< T >::x, and VECTOR2< T >::y.

◆ PlotPoly() [1/2]

void PLOTTER::PlotPoly ( const SHAPE_LINE_CHAIN aCornerList,
FILL_T  aFill,
int  aWidth = USE_DEFAULT_LINE_WIDTH,
void *  aData = nullptr 
)
virtualinherited

Draw a polygon ( filled or not ).

Parameters
aCornerListis the corners list (a SHAPE_LINE_CHAIN). must be closed (IsClosed() == true) for a polygon. Otherwise this is a polyline.
aFillis the type of fill.
aWidthis the line width.
aDatais an auxiliary info (mainly for gerber format).

Reimplemented in GERBER_PLOTTER.

Definition at line 682 of file plotter.cpp.

683{
684 std::vector<VECTOR2I> cornerList;
685 cornerList.reserve( aCornerList.PointCount() );
686
687 for( int ii = 0; ii < aCornerList.PointCount(); ii++ )
688 cornerList.emplace_back( aCornerList.CPoint( ii ) );
689
690 if( aCornerList.IsClosed() && cornerList.front() != cornerList.back() )
691 cornerList.emplace_back( aCornerList.CPoint( 0 ) );
692
693 PlotPoly( cornerList, aFill, aWidth, aData );
694}
bool IsClosed() const override

References SHAPE_LINE_CHAIN::CPoint(), SHAPE_LINE_CHAIN::IsClosed(), PLOTTER::PlotPoly(), and SHAPE_LINE_CHAIN::PointCount().

◆ PlotPoly() [2/2]

void PS_PLOTTER::PlotPoly ( const std::vector< VECTOR2I > &  aCornerList,
FILL_T  aFill,
int  aWidth = USE_DEFAULT_LINE_WIDTH,
void *  aData = nullptr 
)
overridevirtual

Draw a polygon ( filled or not ).

Parameters
aCornerListis the corners list (a std::vector< VECTOR2I >).
aFillis the type of fill.
aWidthis the line width.
aDatais an auxiliary info (mainly for gerber format).

Implements PLOTTER.

Definition at line 600 of file PS_plotter.cpp.

602{
603 if( aCornerList.size() <= 1 )
604 return;
605
606 SetCurrentLineWidth( aWidth );
607
608 VECTOR2D pos = userToDeviceCoordinates( aCornerList[0] );
609 fprintf( m_outputFile, "newpath\n%g %g moveto\n", pos.x, pos.y );
610
611 for( unsigned ii = 1; ii < aCornerList.size(); ii++ )
612 {
613 pos = userToDeviceCoordinates( aCornerList[ii] );
614 fprintf( m_outputFile, "%g %g lineto\n", pos.x, pos.y );
615 }
616
617 // Close/(fill) the path
618 fprintf( m_outputFile, "poly%d\n", getFillId( aFill ) );
619}

References getFillId(), PLOTTER::m_outputFile, SetCurrentLineWidth(), PLOTTER::userToDeviceCoordinates(), VECTOR2< T >::x, and VECTOR2< T >::y.

◆ postscriptOverlinePositions()

void PSLIKE_PLOTTER::postscriptOverlinePositions ( const wxString &  aText,
int  aXSize,
bool  aItalic,
bool  aBold,
std::vector< int > *  pos_pairs 
)
protectedinherited

Computes the x coordinates for the overlining in a string of text.

Fills the passed vector with couples of (start, stop) values to be used in the text coordinate system (use computeTextParameters to obtain the parameters to establish such a system)

Definition at line 352 of file PS_plotter.cpp.

355{
356 /* XXX This function is *too* similar to returnPostscriptTextWidth.
357 Consider merging them... */
358 const double *width_table = aBold ? ( aItalic ? hvbo_widths : hvb_widths )
359 : ( aItalic ? hvo_widths : hv_widths );
360 double tally = 0;
361
362 for( unsigned i = 0; i < aText.length(); i++ )
363 {
364 wchar_t AsciiCode = aText[i];
365
366 // Skip the negation marks and untabled points
367 if( AsciiCode != '~' && AsciiCode < 256 )
368 {
369 tally += width_table[AsciiCode];
370 }
371 else
372 {
373 if( AsciiCode == '~' )
374 pos_pairs->push_back( KiROUND( aXSize * tally / postscriptTextAscent ) );
375 }
376 }
377
378 // Special rule: we have to complete the last bar if the ~ aren't matched
379 if( pos_pairs->size() % 2 == 1 )
380 pos_pairs->push_back( KiROUND( aXSize * tally / postscriptTextAscent ) );
381}
const double hvbo_widths[256]
Character widths for Helvetica-BoldOblique.
const double hvb_widths[256]
Character widths for Helvetica-Bold.
const double hv_widths[256]
Character widths for Helvetica.
Definition: PS_plotter.cpp:973
const double hvo_widths[256]
Character widths for Helvetica-Oblique.

References hv_widths, hvb_widths, hvbo_widths, hvo_widths, KiROUND(), and PSLIKE_PLOTTER::postscriptTextAscent.

◆ Rect()

void PS_PLOTTER::Rect ( const VECTOR2I p1,
const VECTOR2I p2,
FILL_T  fill,
int  width = USE_DEFAULT_LINE_WIDTH 
)
overridevirtual

Implements PLOTTER.

Definition at line 546 of file PS_plotter.cpp.

547{
548 VECTOR2D p1_dev = userToDeviceCoordinates( p1 );
549 VECTOR2D p2_dev = userToDeviceCoordinates( p2 );
550
551 SetCurrentLineWidth( width );
552 fprintf( m_outputFile, "%g %g %g %g rect%d\n", p1_dev.x, p1_dev.y,
553 p2_dev.x - p1_dev.x, p2_dev.y - p1_dev.y, getFillId( fill ) );
554}

References getFillId(), PLOTTER::m_outputFile, SetCurrentLineWidth(), PLOTTER::userToDeviceCoordinates(), VECTOR2< T >::x, and VECTOR2< T >::y.

Referenced by SCH_PLOTTER::plotOneSheetPS().

◆ RenderSettings()

◆ returnPostscriptTextWidth()

int PSLIKE_PLOTTER::returnPostscriptTextWidth ( const wxString &  aText,
int  aXSize,
bool  aItalic,
bool  aBold 
)
protectedinherited

Sister function for the GraphicTextWidth in drawtxt.cpp Does the same processing (i.e.

calculates a text string width) but using postscript metrics for the Helvetica font (optionally used for PS and PDF plotting

Definition at line 329 of file PS_plotter.cpp.

331{
332 const double *width_table = aBold ? ( aItalic ? hvbo_widths : hvb_widths )
333 : ( aItalic ? hvo_widths : hv_widths );
334 double tally = 0;
335
336 for( unsigned i = 0; i < aText.length(); i++ )
337 {
338 wchar_t AsciiCode = aText[i];
339
340 // Skip the negation marks and untabled points.
341 if( AsciiCode != '~' && AsciiCode < 256 )
342 {
343 tally += width_table[AsciiCode];
344 }
345 }
346
347 // Widths are proportional to height, but height is enlarged by a scaling factor.
348 return KiROUND( aXSize * tally / postscriptTextAscent );
349}

References hv_widths, hvb_widths, hvbo_widths, hvo_widths, KiROUND(), and PSLIKE_PLOTTER::postscriptTextAscent.

Referenced by PSLIKE_PLOTTER::computeTextParameters().

◆ segmentAsOval()

void PLOTTER::segmentAsOval ( const VECTOR2I start,
const VECTOR2I end,
int  width,
OUTLINE_MODE  tracemode 
)
protectedinherited

Convert a thick segment and plot it as an oval.

Definition at line 481 of file plotter.cpp.

483{
484 VECTOR2I center( ( start.x + end.x ) / 2, ( start.y + end.y ) / 2 );
485 VECTOR2I size( end.x - start.x, end.y - start.y );
486 EDA_ANGLE orient( size );
487 orient = -orient; // this is due to our Y axis orientation
488
489 size.x = KiROUND( EuclideanNorm( size ) ) + aWidth;
490 size.y = aWidth;
491
492 FlashPadOval( center, size, orient, aTraceMode, nullptr );
493}
virtual void FlashPadOval(const VECTOR2I &aPadPos, const VECTOR2I &aSize, const EDA_ANGLE &aPadOrient, OUTLINE_MODE aTraceMode, void *aData)=0

References EuclideanNorm(), PLOTTER::FlashPadOval(), KiROUND(), VECTOR2< T >::x, and VECTOR2< T >::y.

Referenced by PLOTTER::ThickSegment(), GERBER_PLOTTER::ThickSegment(), and HPGL_PLOTTER::ThickSegment().

◆ SetColor()

void PSLIKE_PLOTTER::SetColor ( const COLOR4D color)
overridevirtualinherited

The SetColor implementation is split with the subclasses: The PSLIKE computes the rgb values, the subclass emits the operator to actually do it.

Implements PLOTTER.

Reimplemented in SVG_PLOTTER.

Definition at line 62 of file PS_plotter.cpp.

63{
64 if( m_colorMode )
65 {
66 if( m_negativeMode )
67 emitSetRGBColor( 1 - color.r, 1 - color.g, 1 - color.b, color.a );
68 else
70 }
71 else
72 {
73 /* B/W Mode - Use BLACK or WHITE for all items
74 * note the 2 colors are used in B&W mode, mainly by Pcbnew to draw
75 * holes in white on pads in black
76 */
77 double k = 1; // White
78
79 if( color != COLOR4D::WHITE )
80 k = 0;
81
82 if( m_negativeMode )
83 emitSetRGBColor( 1 - k, 1 - k, 1 - k, 1.0 );
84 else
85 emitSetRGBColor( k, k, k, 1.0 );
86 }
87}
int color
Definition: DXF_plotter.cpp:57
bool m_negativeMode
Definition: plotter.h:637
virtual void emitSetRGBColor(double r, double g, double b, double a)=0
Virtual primitive for emitting the setrgbcolor operator.
@ WHITE
Definition: color4d.h:48

References color, PSLIKE_PLOTTER::emitSetRGBColor(), PLOTTER::m_colorMode, PLOTTER::m_negativeMode, and WHITE.

Referenced by SCH_PLOTTER::plotOneSheetPS(), SVG_PLOTTER::SetColor(), Text(), and PDF_PLOTTER::Text().

◆ SetColorMode()

virtual void PLOTTER::SetColorMode ( bool  aColorMode)
inlinevirtualinherited

◆ SetCreator()

◆ SetCurrentLineWidth()

void PS_PLOTTER::SetCurrentLineWidth ( int  width,
void *  aData = nullptr 
)
overridevirtual

Set the current line width (in IUs) for the next plot.

Implements PLOTTER.

Definition at line 473 of file PS_plotter.cpp.

474{
475 wxASSERT( m_outputFile );
476
477 if( aWidth == DO_NOT_SET_LINE_WIDTH )
478 return;
479 else if( aWidth == USE_DEFAULT_LINE_WIDTH )
481 else if( aWidth == 0 )
482 aWidth = 1;
483
484 wxASSERT_MSG( aWidth > 0, "Plotter called to set negative pen width" );
485
486 if( aWidth != GetCurrentLineWidth() )
487 fprintf( m_outputFile, "%g setlinewidth\n", userToDeviceSize( aWidth ) );
488
489 m_currentPenWidth = aWidth;
490}
int GetDefaultPenWidth() const
static const int DO_NOT_SET_LINE_WIDTH
Definition: plotter.h:113

References PLOTTER::DO_NOT_SET_LINE_WIDTH, PLOTTER::GetCurrentLineWidth(), KIGFX::RENDER_SETTINGS::GetDefaultPenWidth(), PLOTTER::m_currentPenWidth, PLOTTER::m_outputFile, PLOTTER::m_renderSettings, PLOTTER::USE_DEFAULT_LINE_WIDTH, and PLOTTER::userToDeviceSize().

Referenced by Arc(), Circle(), PlotPoly(), Rect(), and Text().

◆ SetDash()

void PS_PLOTTER::SetDash ( int  aLineWidth,
PLOT_DASH_TYPE  aLineStyle 
)
overridevirtual

PostScript supports dashed lines.

Implements PLOTTER.

Definition at line 513 of file PS_plotter.cpp.

514{
515 switch( aLineStyle )
516 {
518 fprintf( m_outputFile, "[%d %d] 0 setdash\n",
519 (int) GetDashMarkLenIU( aLineWidth ), (int) GetDashGapLenIU( aLineWidth ) );
520 break;
521
523 fprintf( m_outputFile, "[%d %d] 0 setdash\n",
524 (int) GetDotMarkLenIU( aLineWidth ), (int) GetDashGapLenIU( aLineWidth ) );
525 break;
526
528 fprintf( m_outputFile, "[%d %d %d %d] 0 setdash\n",
529 (int) GetDashMarkLenIU( aLineWidth ), (int) GetDashGapLenIU( aLineWidth ),
530 (int) GetDotMarkLenIU( aLineWidth ), (int) GetDashGapLenIU( aLineWidth ) );
531 break;
532
534 fprintf( m_outputFile, "[%d %d %d %d %d %d] 0 setdash\n",
535 (int) GetDashMarkLenIU( aLineWidth ), (int) GetDashGapLenIU( aLineWidth ),
536 (int) GetDotMarkLenIU( aLineWidth ), (int) GetDashGapLenIU( aLineWidth ),
537 (int) GetDotMarkLenIU( aLineWidth ), (int) GetDashGapLenIU( aLineWidth ) );
538 break;
539
540 default:
541 fputs( "solidline\n", m_outputFile );
542 }
543}
double GetDotMarkLenIU(int aLineWidth) const
Definition: plotter.cpp:131
double GetDashGapLenIU(int aLineWidth) const
Definition: plotter.cpp:143
double GetDashMarkLenIU(int aLineWidth) const
Definition: plotter.cpp:137

References DASH, DASHDOT, DASHDOTDOT, DOT, PLOTTER::GetDashGapLenIU(), PLOTTER::GetDashMarkLenIU(), PLOTTER::GetDotMarkLenIU(), and PLOTTER::m_outputFile.

◆ SetGerberCoordinatesFormat()

virtual void PLOTTER::SetGerberCoordinatesFormat ( int  aResolution,
bool  aUseInches = false 
)
inlinevirtualinherited

Reimplemented in GERBER_PLOTTER.

Definition at line 500 of file plotter.h.

501 {
502 // NOP for most plotters. Only for Gerber plotter
503 }

Referenced by GENDRILL_WRITER_BASE::genDrillMapFile(), and initializePlotter().

◆ SetLayerPolarity()

virtual void PLOTTER::SetLayerPolarity ( bool  aPositive)
inlinevirtualinherited

Set the current Gerber layer polarity to positive or negative by writing %LPD*% or %LPC*% to the Gerber file, respectively.

(obviously starts a new Gerber layer, too)

Parameters
aPositiveis the layer polarity and true for positive. It's not useful with most other plotter since they can't 'scratch' the film like photoplotter imagers do

Reimplemented in GERBER_PLOTTER.

Definition at line 486 of file plotter.h.

487 {
488 // NOP for most plotters
489 }

Referenced by PlotOneBoardLayer().

◆ SetNegative()

virtual void PLOTTER::SetNegative ( bool  aNegative)
inlinevirtualinherited

Definition at line 130 of file plotter.h.

130{ m_negativeMode = aNegative; }

References PLOTTER::m_negativeMode.

Referenced by FillNegativeKnockout().

◆ SetPageSettings()

◆ SetRenderSettings()

◆ SetScaleAdjust()

void PSLIKE_PLOTTER::SetScaleAdjust ( double  scaleX,
double  scaleY 
)
inlineinherited

Set the 'fine' scaling for the postscript engine.

Definition at line 57 of file plotters_pslike.h.

58 {
59 plotScaleAdjX = scaleX;
60 plotScaleAdjY = scaleY;
61 }
double plotScaleAdjX
Fine user scale adjust ( = 1.0 if no correction)

References PSLIKE_PLOTTER::plotScaleAdjX, and PSLIKE_PLOTTER::plotScaleAdjY.

Referenced by StartPlotBoard().

◆ SetSvgCoordinatesFormat()

virtual void PLOTTER::SetSvgCoordinatesFormat ( unsigned  aPrecision)
inlinevirtualinherited

Set the number of digits for mantissa in coordinates in mm for SVG plotter.

Reimplemented in SVG_PLOTTER.

Definition at line 506 of file plotter.h.

507 {
508 // NOP for most plotters. Only for SVG plotter
509 }

Referenced by initializePlotter().

◆ SetTextMode()

virtual void PSLIKE_PLOTTER::SetTextMode ( PLOT_TEXT_MODE  mode)
inlineoverridevirtualinherited

PS and PDF fully implement native text (for the Latin-1 subset)

Reimplemented from PLOTTER.

Definition at line 48 of file plotters_pslike.h.

49 {
50 if( mode != PLOT_TEXT_MODE::DEFAULT )
51 m_textMode = mode;
52 }

References DEFAULT, and PSLIKE_PLOTTER::m_textMode.

Referenced by SVG_PLOTTER::SVG_PLOTTER().

◆ SetTitle()

virtual void PLOTTER::SetTitle ( const wxString &  aTitle)
inlinevirtualinherited

Definition at line 161 of file plotter.h.

161{ m_title = aTitle; }
wxString m_title
Definition: plotter.h:644

References PLOTTER::m_title.

Referenced by SCH_PLOTTER::createPDFFile().

◆ SetViewport()

void PS_PLOTTER::SetViewport ( const VECTOR2I aOffset,
double  aIusPerDecimil,
double  aScale,
bool  aMirror 
)
overridevirtual

Set the plot offset and scaling for the current plot.

Parameters
aOffsetis the plot offset.
aIusPerDecimilgives the scaling factor from IUs to device units
aScaleis the user set plot scaling factor (either explicitly or using 'fit to A4').
aMirrorflips the plot in the Y direction (useful for toner transfers or some kind of film).

Implements PLOTTER.

Definition at line 384 of file PS_plotter.cpp.

386{
387 wxASSERT( !m_outputFile );
388 m_plotMirror = aMirror;
389 m_plotOffset = aOffset;
390 m_plotScale = aScale;
391 m_IUsPerDecimil = aIusPerDecimil;
392 m_iuPerDeviceUnit = 1.0 / aIusPerDecimil;
393
394 /* Compute the paper size in IUs */
396 m_paperSize.x *= 10.0 * aIusPerDecimil;
397 m_paperSize.y *= 10.0 * aIusPerDecimil;
398}
const VECTOR2I & GetSizeMils() const
Definition: page_info.h:135
double m_iuPerDeviceUnit
Definition: plotter.h:624
VECTOR2I m_plotOffset
Definition: plotter.h:626
VECTOR2I m_paperSize
Definition: plotter.h:646
double m_plotScale
Plot scale - chosen by the user (even implicitly with 'fit in a4')
Definition: plotter.h:616

References PAGE_INFO::GetSizeMils(), PLOTTER::m_iuPerDeviceUnit, PLOTTER::m_IUsPerDecimil, PLOTTER::m_outputFile, PLOTTER::m_pageInfo, PLOTTER::m_paperSize, PLOTTER::m_plotMirror, PLOTTER::m_plotOffset, PLOTTER::m_plotScale, VECTOR2< T >::x, and VECTOR2< T >::y.

Referenced by SCH_PLOTTER::plotOneSheetPS().

◆ sketchOval()

void PLOTTER::sketchOval ( const VECTOR2I aPos,
const VECTOR2I aSize,
const EDA_ANGLE aOrient,
int  aWidth 
)
protectedinherited

Definition at line 496 of file plotter.cpp.

498{
499 SetCurrentLineWidth( aWidth );
500
501 EDA_ANGLE orient( aOrient );
502 VECTOR2I size( aSize );
503
504 if( size.x > size.y )
505 {
506 std::swap( size.x, size.y );
507 orient += ANGLE_90;
508 }
509
510 int deltaxy = size.y - size.x; /* distance between centers of the oval */
511 int radius = size.x / 2;
512
513 // Build a vertical oval shape giving the start and end points of arcs and edges,
514 // and the middle point of arcs
515 std::vector<VECTOR2I> corners;
516 corners.reserve( 6 );
517 // Shape is (x = corner and arc ends, c = arc centre)
518 // xcx
519 //
520 // xcx
521 int half_height = deltaxy / 2;
522 corners.emplace_back( -radius, -half_height );
523 corners.emplace_back( -radius, half_height );
524 corners.emplace_back( 0, half_height );
525 corners.emplace_back( radius, half_height );
526 corners.emplace_back( radius, -half_height );
527 corners.emplace_back( 0, -half_height );
528
529 // Rotate and move to the actual position
530 for( size_t ii = 0; ii < corners.size(); ii++ )
531 {
532 RotatePoint( corners[ii], orient );
533 corners[ii] += aPos;
534 }
535
536 // Gen shape:
537 MoveTo( corners[0] );
538 FinishTo( corners[1] );
539
540 Arc( corners[2], orient + ANGLE_180, orient + ANGLE_360, radius, FILL_T::NO_FILL );
541
542 MoveTo( corners[3] );
543 FinishTo( corners[4] );
544
545 Arc( corners[5], orient, orient + ANGLE_180, radius, FILL_T::NO_FILL );
546}
virtual void Arc(const VECTOR2I &aCenter, const VECTOR2I &aStart, const VECTOR2I &aEnd, FILL_T aFill, int aWidth, int aMaxError)
Generic fallback: arc rendered as a polyline.
Definition: plotter.cpp:149
static constexpr EDA_ANGLE & ANGLE_180
Definition: eda_angle.h:416
static constexpr EDA_ANGLE & ANGLE_360
Definition: eda_angle.h:418

References ANGLE_180, ANGLE_360, ANGLE_90, PLOTTER::Arc(), PLOTTER::FinishTo(), PLOTTER::MoveTo(), NO_FILL, RotatePoint(), PLOTTER::SetCurrentLineWidth(), VECTOR2< T >::x, and VECTOR2< T >::y.

Referenced by GERBER_PLOTTER::FlashPadOval(), HPGL_PLOTTER::FlashPadOval(), PSLIKE_PLOTTER::FlashPadOval(), and DXF_PLOTTER::FlashPadOval().

◆ StartBlock()

virtual void PLOTTER::StartBlock ( void *  aData)
inlinevirtualinherited

calling this function allows one to define the beginning of a group of drawing items, for instance in SVG or Gerber format.

(example: group all segments of a letter or a text)

Parameters
aDatacan define any parameter for most of plotters: do nothing

Reimplemented in GERBER_PLOTTER, and SVG_PLOTTER.

Definition at line 518 of file plotter.h.

518{}

Referenced by SCH_SYMBOL::Plot(), BRDITEMS_PLOTTER::PlotFilledAreas(), and PlotStandardLayer().

◆ StartPlot()

bool PS_PLOTTER::StartPlot ( const wxString &  aPageNumber)
overridevirtual

The code within this function (and the CloseFilePS function) creates postscript files whose contents comply with Adobe's Document Structuring Convention, as documented by assorted details described within the following URLs:

http://en.wikipedia.org/wiki/Document_Structuring_Conventions http://partners.adobe.com/public/developer/en/ps/5001.DSC_Spec.pdf

BBox is the boundary box (position and size of the "client rectangle" for drawings (page - margins) in mils (0.001 inch)

Implements PLOTTER.

Definition at line 765 of file PS_plotter.cpp.

766{
767 wxASSERT( m_outputFile );
768
769 static const char* PSMacro[] =
770 {
771 "%%BeginProlog\n",
772 "/line { newpath moveto lineto stroke } bind def\n",
773 "/cir0 { newpath 0 360 arc stroke } bind def\n",
774 "/cir1 { newpath 0 360 arc gsave fill grestore stroke } bind def\n",
775 "/cir2 { newpath 0 360 arc gsave fill grestore stroke } bind def\n",
776 "/arc0 { newpath arc stroke } bind def\n",
777 "/arc1 { newpath 4 index 4 index moveto arc closepath gsave fill\n",
778 " grestore stroke } bind def\n",
779 "/arc2 { newpath 4 index 4 index moveto arc closepath gsave fill\n",
780 " grestore stroke } bind def\n",
781 "/poly0 { stroke } bind def\n",
782 "/poly1 { closepath gsave fill grestore stroke } bind def\n",
783 "/poly2 { closepath gsave fill grestore stroke } bind def\n",
784 "/rect0 { rectstroke } bind def\n",
785 "/rect1 { rectfill } bind def\n",
786 "/rect2 { rectfill } bind def\n",
787 "/linemode0 { 0 setlinecap 0 setlinejoin 0 setlinewidth } bind def\n",
788 "/linemode1 { 1 setlinecap 1 setlinejoin } bind def\n",
789 "/dashedline { [200] 100 setdash } bind def\n",
790 "/solidline { [] 0 setdash } bind def\n",
791
792 // This is for 'hidden' text (search anchors for PDF)
793 "/phantomshow { moveto\n",
794 " /KicadFont findfont 0.000001 scalefont setfont\n",
795 " show } bind def\n",
796
797 // This is for regular postscript text
798 "/textshow { gsave\n",
799 " findfont exch scalefont setfont concat 1 scale 0 0 moveto show\n",
800 " } bind def\n",
801
802 // Utility for getting Latin1 encoded fonts
803 "/reencodefont {\n",
804 " findfont dup length dict begin\n",
805 " { 1 index /FID ne\n",
806 " { def }\n",
807 " { pop pop } ifelse\n",
808 " } forall\n",
809 " /Encoding ISOLatin1Encoding def\n",
810 " currentdict\n",
811 " end } bind def\n"
812
813 // Remap AdobeStandard fonts to Latin1
814 "/KicadFont /Helvetica reencodefont definefont pop\n",
815 "/KicadFont-Bold /Helvetica-Bold reencodefont definefont pop\n",
816 "/KicadFont-Oblique /Helvetica-Oblique reencodefont definefont pop\n",
817 "/KicadFont-BoldOblique /Helvetica-BoldOblique reencodefont definefont pop\n",
818 "%%EndProlog\n",
819 nullptr
820 };
821
822 time_t time1970 = time( nullptr );
823
824 fputs( "%!PS-Adobe-3.0\n", m_outputFile ); // Print header
825
826 fprintf( m_outputFile, "%%%%Creator: %s\n", TO_UTF8( m_creator ) );
827
828 /* A "newline" character ("\n") is not included in the following string,
829 because it is provided by the ctime() function. */
830 fprintf( m_outputFile, "%%%%CreationDate: %s", ctime( &time1970 ) );
831 fprintf( m_outputFile, "%%%%Title: %s\n", encodeStringForPlotter( m_title ).c_str() );
832 fprintf( m_outputFile, "%%%%Pages: 1\n" );
833 fprintf( m_outputFile, "%%%%PageOrder: Ascend\n" );
834
835 // Print boundary box in 1/72 pixels per inch, box is in mils
836 const double BIGPTsPERMIL = 0.072;
837
838 /* The coordinates of the lower left corner of the boundary
839 box need to be "rounded down", but the coordinates of its
840 upper right corner need to be "rounded up" instead. */
841 VECTOR2I psPaperSize = m_pageInfo.GetSizeMils();
842
843 if( !m_pageInfo.IsPortrait() )
844 {
845 psPaperSize.x = m_pageInfo.GetHeightMils();
846 psPaperSize.y = m_pageInfo.GetWidthMils();
847 }
848
849 fprintf( m_outputFile, "%%%%BoundingBox: 0 0 %d %d\n",
850 (int) ceil( psPaperSize.x * BIGPTsPERMIL ),
851 (int) ceil( psPaperSize.y * BIGPTsPERMIL ) );
852
853 // Specify the size of the sheet and the name associated with that size.
854 // (If the "User size" option has been selected for the sheet size,
855 // identify the sheet size as "Custom" (rather than as "User"), but
856 // otherwise use the name assigned by KiCad for each sheet size.)
857 //
858 // (The Document Structuring Convention also supports sheet weight,
859 // sheet color, and sheet type properties being specified within a
860 // %%DocumentMedia comment, but they are not being specified here;
861 // a zero and two null strings are subsequently provided instead.)
862 //
863 // (NOTE: m_Size.y is *supposed* to be listed before m_Size.x;
864 // the order in which they are specified is not wrong!)
865 // Also note pageSize is given in mils, not in internal units and must be
866 // converted to internal units.
867
868 if( m_pageInfo.IsCustom() )
869 {
870 fprintf( m_outputFile, "%%%%DocumentMedia: Custom %d %d 0 () ()\n",
871 KiROUND( psPaperSize.x * BIGPTsPERMIL ),
872 KiROUND( psPaperSize.y * BIGPTsPERMIL ) );
873 }
874 else // a standard paper size
875 {
876 fprintf( m_outputFile, "%%%%DocumentMedia: %s %d %d 0 () ()\n",
878 KiROUND( psPaperSize.x * BIGPTsPERMIL ),
879 KiROUND( psPaperSize.y * BIGPTsPERMIL ) );
880 }
881
882 if( m_pageInfo.IsPortrait() )
883 fprintf( m_outputFile, "%%%%Orientation: Portrait\n" );
884 else
885 fprintf( m_outputFile, "%%%%Orientation: Landscape\n" );
886
887 fprintf( m_outputFile, "%%%%EndComments\n" );
888
889 // Now specify various other details.
890
891 for( int ii = 0; PSMacro[ii] != nullptr; ii++ )
892 {
893 fputs( PSMacro[ii], m_outputFile );
894 }
895
896 // The following strings are output here (rather than within PSMacro[])
897 // to highlight that it has been provided to ensure that the contents of
898 // the postscript file comply with the Document Structuring Convention.
899 std::string page_num = encodeStringForPlotter( aPageNumber );
900
901 fprintf( m_outputFile, "%%Page: %s 1\n", page_num.c_str() );
902
903 fputs( "%%BeginPageSetup\n"
904 "gsave\n"
905 "0.0072 0.0072 scale\n" // Configure postscript for decimils coordinates
906 "linemode1\n", m_outputFile );
907
908
909 // Rototranslate the coordinate to achieve the landscape layout
910 if( !m_pageInfo.IsPortrait() )
911 fprintf( m_outputFile, "%d 0 translate 90 rotate\n", 10 * psPaperSize.x );
912
913 // Apply the user fine scale adjustments
914 if( plotScaleAdjX != 1.0 || plotScaleAdjY != 1.0 )
915 fprintf( m_outputFile, "%g %g scale\n", plotScaleAdjX, plotScaleAdjY );
916
917 // Set default line width
918 fprintf( m_outputFile, "%g setlinewidth\n",
920 fputs( "%%EndPageSetup\n", m_outputFile );
921
922 return true;
923}
int GetHeightMils() const
Definition: page_info.h:133
int GetWidthMils() const
Definition: page_info.h:130
const wxString & GetType() const
Definition: page_info.h:94
bool IsCustom() const
Definition: page_info.cpp:181
bool IsPortrait() const
Definition: page_info.h:117
virtual std::string encodeStringForPlotter(const wxString &aUnicode)
convert a wxString unicode string to a char string compatible with the accepted string plotter format...
Definition: PS_plotter.cpp:289
#define TO_UTF8(wxstring)
Convert a wxString to a UTF8 encoded C string for all wxWidgets build modes.
Definition: macros.h:96

References PSLIKE_PLOTTER::encodeStringForPlotter(), KIGFX::RENDER_SETTINGS::GetDefaultPenWidth(), PAGE_INFO::GetHeightMils(), PAGE_INFO::GetSizeMils(), PAGE_INFO::GetType(), PAGE_INFO::GetWidthMils(), PAGE_INFO::IsCustom(), PAGE_INFO::IsPortrait(), KiROUND(), PLOTTER::m_creator, PLOTTER::m_outputFile, PLOTTER::m_pageInfo, PLOTTER::m_renderSettings, PLOTTER::m_title, PSLIKE_PLOTTER::plotScaleAdjX, PSLIKE_PLOTTER::plotScaleAdjY, TO_UTF8, PLOTTER::userToDeviceSize(), VECTOR2< T >::x, and VECTOR2< T >::y.

Referenced by SCH_PLOTTER::plotOneSheetPS().

◆ Text()

void PS_PLOTTER::Text ( const VECTOR2I aPos,
const COLOR4D aColor,
const wxString &  aText,
const EDA_ANGLE aOrient,
const VECTOR2I aSize,
enum GR_TEXT_H_ALIGN_T  aH_justify,
enum GR_TEXT_V_ALIGN_T  aV_justify,
int  aPenWidth,
bool  aItalic,
bool  aBold,
bool  aMultilineAllowed = false,
KIFONT::FONT aFont = nullptr,
void *  aData = nullptr 
)
overridevirtual

Draw text with the plotter.

Same as GRText, but plot graphic text instead of draw it.

For convenience it accept the color to use for specific plotters (GERBER) aData is used to pass extra parameters.

Parameters
aPosis the text position (according to aH_justify, aV_justify).
aColoris the text color.
aTextis the text to draw.
aOrientis the angle.
aSizeis the text size (size.x or size.y can be < 0 for mirrored texts).
aH_justifyis the horizontal justification (Left, center, right).
aV_justifyis the vertical justification (bottom, center, top).
aPenWidthis the line width (if = 0, use plot default line width).
aItalicis the true to simulate an italic font.
aBolduse true to use a bold font Useful only with default width value (aPenWidth = 0).
aMultilineAlloweduse true to plot text as multiline, otherwise single line.
aDatais a parameter used by some plotters in SetCurrentLineWidth(), not directly used here.

Reimplemented from PLOTTER.

Definition at line 940 of file PS_plotter.cpp.

953{
954 SetCurrentLineWidth( aWidth );
955 SetColor( aColor );
956
957 // Draw the hidden postscript text (if requested)
959 {
960 std::string ps_test = encodeStringForPlotter( aText );
961 VECTOR2D pos_dev = userToDeviceCoordinates( aPos );
962 fprintf( m_outputFile, "%s %g %g phantomshow\n", ps_test.c_str(), pos_dev.x, pos_dev.y );
963 }
964
965 PLOTTER::Text( aPos, aColor, aText, aOrient, aSize, aH_justify, aV_justify, aWidth, aItalic,
966 aBold, aMultilineAllowed, aFont, aData );
967}
virtual void Text(const VECTOR2I &aPos, const COLOR4D &aColor, const wxString &aText, const EDA_ANGLE &aOrient, const VECTOR2I &aSize, enum GR_TEXT_H_ALIGN_T aH_justify, enum GR_TEXT_V_ALIGN_T aV_justify, int aPenWidth, bool aItalic, bool aBold, bool aMultilineAllowed, KIFONT::FONT *aFont, void *aData=nullptr)
Draw text with the plotter.
Definition: plotter.cpp:714
virtual void SetColor(const COLOR4D &color) override
The SetColor implementation is split with the subclasses: The PSLIKE computes the rgb values,...
Definition: PS_plotter.cpp:62

References PSLIKE_PLOTTER::encodeStringForPlotter(), PLOTTER::m_outputFile, PSLIKE_PLOTTER::m_textMode, PHANTOM, PSLIKE_PLOTTER::SetColor(), SetCurrentLineWidth(), PLOTTER::Text(), PLOTTER::userToDeviceCoordinates(), VECTOR2< T >::x, and VECTOR2< T >::y.

◆ ThickArc() [1/3]

void PLOTTER::ThickArc ( const EDA_SHAPE aArcShape,
OUTLINE_MODE  aTraceMode,
void *  aData 
)
virtualinherited

Reimplemented in GERBER_PLOTTER.

Definition at line 620 of file plotter.cpp.

622{
623 ThickArc( aArcShape.getCenter(),aArcShape.GetStart(), aArcShape.GetEnd(),
624 aArcShape.GetWidth(), aTraceMode, aData );
625}
VECTOR2I getCenter() const
Definition: eda_shape.cpp:400
const VECTOR2I & GetEnd() const
Return the ending point of the graphic.
Definition: eda_shape.h:141
const VECTOR2I & GetStart() const
Return the starting point of the graphic.
Definition: eda_shape.h:116
int GetWidth() const
Definition: eda_shape.h:107
virtual void ThickArc(const VECTOR2I &aCentre, const VECTOR2I &aStart, const VECTOR2I &aEnd, int aWidth, OUTLINE_MODE aTraceMode, void *aData)
Definition: plotter.cpp:592

References EDA_SHAPE::getCenter(), EDA_SHAPE::GetEnd(), EDA_SHAPE::GetStart(), EDA_SHAPE::GetWidth(), and PLOTTER::ThickArc().

◆ ThickArc() [2/3]

void PLOTTER::ThickArc ( const VECTOR2I aCentre,
const EDA_ANGLE StAngle,
const EDA_ANGLE EndAngle,
int  aRadius,
int  aWidth,
OUTLINE_MODE  aTraceMode,
void *  aData 
)
protectedvirtualinherited

Reimplemented in GERBER_PLOTTER.

Definition at line 573 of file plotter.cpp.

576{
577 if( aTraceMode == FILLED )
578 {
579 Arc( centre, aStartAngle, aEndAngle, aRadius, FILL_T::NO_FILL, aWidth );
580 }
581 else
582 {
584 Arc( centre, aStartAngle, aEndAngle, aRadius - ( aWidth - m_currentPenWidth ) / 2,
585 FILL_T::NO_FILL, -1 );
586 Arc( centre, aStartAngle, aEndAngle, aRadius + ( aWidth - m_currentPenWidth ) / 2,
587 FILL_T::NO_FILL, -1 );
588 }
589}

References PLOTTER::Arc(), FILLED, PLOTTER::m_currentPenWidth, NO_FILL, and PLOTTER::SetCurrentLineWidth().

◆ ThickArc() [3/3]

void PLOTTER::ThickArc ( const VECTOR2I aCentre,
const VECTOR2I aStart,
const VECTOR2I aEnd,
int  aWidth,
OUTLINE_MODE  aTraceMode,
void *  aData 
)
virtualinherited

Reimplemented in GERBER_PLOTTER.

Definition at line 592 of file plotter.cpp.

595{
596 if( aTraceMode == FILLED )
597 {
598 Arc( aCentre, aStart, aEnd, FILL_T::NO_FILL, aWidth, GetPlotterArcHighDef() );
599 }
600 else
601 {
603 int radius = ( aStart - aCentre ).EuclideanNorm();
604
605 int new_radius = radius - ( aWidth - m_currentPenWidth ) / 2;
606 VECTOR2I start = ( aStart - aCentre ).Resize( new_radius ) + aCentre;
607 VECTOR2I end = ( aEnd - aCentre ).Resize( new_radius ) + aCentre;
608
609 Arc( aCentre, start, end, FILL_T::NO_FILL, -1, GetPlotterArcHighDef() );
610
611 new_radius = radius + ( aWidth - m_currentPenWidth ) / 2;
612 start = ( aStart - aCentre ).Resize( new_radius ) + aCentre;
613 end = ( aEnd - aCentre ).Resize( new_radius ) + aCentre;
614
615 Arc( aCentre, start, end, FILL_T::NO_FILL, -1, GetPlotterArcHighDef() );
616 }
617}

References PLOTTER::Arc(), EuclideanNorm(), FILLED, PLOTTER::GetPlotterArcHighDef(), PLOTTER::m_currentPenWidth, NO_FILL, and PLOTTER::SetCurrentLineWidth().

Referenced by BRDITEMS_PLOTTER::PlotFootprintShape(), BRDITEMS_PLOTTER::PlotPcbShape(), PlotStandardLayer(), and PLOTTER::ThickArc().

◆ ThickCircle()

void PLOTTER::ThickCircle ( const VECTOR2I pos,
int  diametre,
int  width,
OUTLINE_MODE  tracemode,
void *  aData 
)
virtualinherited

Reimplemented in GERBER_PLOTTER.

Definition at line 652 of file plotter.cpp.

654{
655 if( tracemode == FILLED )
656 {
657 Circle( pos, diametre, FILL_T::NO_FILL, width );
658 }
659 else
660 {
662 Circle( pos, diametre - width + m_currentPenWidth, FILL_T::NO_FILL, -1 );
663 Circle( pos, diametre + width - m_currentPenWidth, FILL_T::NO_FILL, -1 );
664 }
665}

References PLOTTER::Circle(), FILLED, PLOTTER::m_currentPenWidth, NO_FILL, and PLOTTER::SetCurrentLineWidth().

Referenced by BRDITEMS_PLOTTER::PlotFootprintShape(), and BRDITEMS_PLOTTER::PlotPcbShape().

◆ ThickRect()

void PLOTTER::ThickRect ( const VECTOR2I p1,
const VECTOR2I p2,
int  width,
OUTLINE_MODE  tracemode,
void *  aData 
)
virtualinherited

Reimplemented in GERBER_PLOTTER.

Definition at line 628 of file plotter.cpp.

630{
631 if( tracemode == FILLED )
632 {
633 Rect( p1, p2, FILL_T::NO_FILL, width );
634 }
635 else
636 {
638 VECTOR2I offsetp1( p1.x - ( width - m_currentPenWidth ) / 2,
639 p1.y - (width - m_currentPenWidth) / 2 );
640 VECTOR2I offsetp2( p2.x + ( width - m_currentPenWidth ) / 2,
641 p2.y + (width - m_currentPenWidth) / 2 );
642 Rect( offsetp1, offsetp2, FILL_T::NO_FILL, -1 );
643 offsetp1.x += ( width - m_currentPenWidth );
644 offsetp1.y += ( width - m_currentPenWidth );
645 offsetp2.x -= ( width - m_currentPenWidth );
646 offsetp2.y -= ( width - m_currentPenWidth );
647 Rect( offsetp1, offsetp2, FILL_T::NO_FILL, -1 );
648 }
649}
virtual void Rect(const VECTOR2I &p1, const VECTOR2I &p2, FILL_T fill, int width=USE_DEFAULT_LINE_WIDTH)=0

References FILLED, PLOTTER::m_currentPenWidth, NO_FILL, PLOTTER::Rect(), PLOTTER::SetCurrentLineWidth(), VECTOR2< T >::x, and VECTOR2< T >::y.

◆ ThickSegment()

void PLOTTER::ThickSegment ( const VECTOR2I start,
const VECTOR2I end,
int  width,
OUTLINE_MODE  tracemode,
void *  aData 
)
virtualinherited

Reimplemented in DXF_PLOTTER, GERBER_PLOTTER, and HPGL_PLOTTER.

Definition at line 549 of file plotter.cpp.

551{
552 if( tracemode == FILLED )
553 {
554 if( start == end )
555 {
556 Circle( start, width, FILL_T::FILLED_SHAPE, 0 );
557 }
558 else
559 {
560 SetCurrentLineWidth( width );
561 MoveTo( start );
562 FinishTo( end );
563 }
564 }
565 else
566 {
568 segmentAsOval( start, end, width, tracemode );
569 }
570}
void segmentAsOval(const VECTOR2I &start, const VECTOR2I &end, int width, OUTLINE_MODE tracemode)
Convert a thick segment and plot it as an oval.
Definition: plotter.cpp:481

References PLOTTER::Circle(), FILLED, FILLED_SHAPE, PLOTTER::FinishTo(), PLOTTER::MoveTo(), PLOTTER::segmentAsOval(), and PLOTTER::SetCurrentLineWidth().

Referenced by PSLIKE_PLOTTER::FlashPadOval(), BRDITEMS_PLOTTER::PlotFootprintShape(), PlotLayerOutlines(), BRDITEMS_PLOTTER::PlotPcbShape(), and PlotStandardLayer().

◆ userToDeviceCoordinates()

VECTOR2D PLOTTER::userToDeviceCoordinates ( const VECTOR2I aCoordinate)
protectedvirtualinherited

Modify coordinates according to the orientation, scale factor, and offsets trace.

Also convert from a VECTOR2I to VECTOR2D, since some output engines needs floating point coordinates.

Definition at line 90 of file plotter.cpp.

91{
92 VECTOR2I pos = aCoordinate - m_plotOffset;
93
94 double x = pos.x * m_plotScale;
95 double y = ( m_paperSize.y - pos.y * m_plotScale );
96
97 if( m_plotMirror )
98 {
100 x = ( m_paperSize.x - pos.x * m_plotScale );
101 else
102 y = pos.y * m_plotScale;
103 }
104
105 if( m_yaxisReversed )
106 y = m_paperSize.y - y;
107
110
111 return VECTOR2D( x, y );
112}
bool m_mirrorIsHorizontal
Definition: plotter.h:629
bool m_yaxisReversed
Definition: plotter.h:630
VECTOR2< double > VECTOR2D
Definition: vector2d.h:617

References PLOTTER::m_iuPerDeviceUnit, PLOTTER::m_mirrorIsHorizontal, PLOTTER::m_paperSize, PLOTTER::m_plotMirror, PLOTTER::m_plotOffset, PLOTTER::m_plotScale, PLOTTER::m_yaxisReversed, VECTOR2< T >::x, and VECTOR2< T >::y.

Referenced by DXF_PLOTTER::Arc(), HPGL_PLOTTER::Arc(), SVG_PLOTTER::Arc(), Arc(), PDF_PLOTTER::Arc(), SVG_PLOTTER::BezierCurve(), HPGL_PLOTTER::Circle(), DXF_PLOTTER::Circle(), Circle(), PDF_PLOTTER::Circle(), SVG_PLOTTER::Circle(), PSLIKE_PLOTTER::computeTextParameters(), GERBER_PLOTTER::FlashPadChamferRoundRect(), HPGL_PLOTTER::FlashPadCircle(), GERBER_PLOTTER::FlashPadCircle(), GERBER_PLOTTER::FlashPadCustom(), GERBER_PLOTTER::FlashPadOval(), GERBER_PLOTTER::FlashPadRect(), GERBER_PLOTTER::FlashPadRoundRect(), GERBER_PLOTTER::FlashPadTrapez(), GERBER_PLOTTER::FlashRegularPolygon(), DXF_PLOTTER::PenTo(), GERBER_PLOTTER::PenTo(), HPGL_PLOTTER::PenTo(), PenTo(), PDF_PLOTTER::PenTo(), SVG_PLOTTER::PenTo(), GERBER_PLOTTER::plotArc(), PlotImage(), PDF_PLOTTER::PlotImage(), HPGL_PLOTTER::PlotPoly(), PlotPoly(), PDF_PLOTTER::PlotPoly(), SVG_PLOTTER::PlotPoly(), HPGL_PLOTTER::Rect(), Rect(), PDF_PLOTTER::Rect(), SVG_PLOTTER::Rect(), DXF_PLOTTER::Text(), Text(), and SVG_PLOTTER::Text().

◆ userToDeviceSize() [1/2]

◆ userToDeviceSize() [2/2]

double PLOTTER::userToDeviceSize ( double  size) const
protectedvirtualinherited

Modify size according to the plotter scale factors (simple double version).

Definition at line 122 of file plotter.cpp.

123{
124 return size * m_plotScale * m_iuPerDeviceUnit;
125}

References PLOTTER::m_iuPerDeviceUnit, and PLOTTER::m_plotScale.

Member Data Documentation

◆ DO_NOT_SET_LINE_WIDTH

◆ m_colorMode

bool PLOTTER::m_colorMode
protectedinherited

◆ m_creator

wxString PLOTTER::m_creator
protectedinherited

◆ m_currentPenWidth

◆ m_filename

wxString PLOTTER::m_filename
protectedinherited

◆ m_headerExtraLines

wxArrayString PLOTTER::m_headerExtraLines
protectedinherited

◆ m_iuPerDeviceUnit

◆ m_IUsPerDecimil

◆ m_mirrorIsHorizontal

bool PLOTTER::m_mirrorIsHorizontal
protectedinherited

Definition at line 629 of file plotter.h.

Referenced by SVG_PLOTTER::Arc(), PLOTTER::PLOTTER(), and PLOTTER::userToDeviceCoordinates().

◆ m_negativeMode

bool PLOTTER::m_negativeMode
protectedinherited

Definition at line 637 of file plotter.h.

Referenced by PLOTTER::PLOTTER(), PSLIKE_PLOTTER::SetColor(), and PLOTTER::SetNegative().

◆ m_outputFile

FILE* PLOTTER::m_outputFile
protectedinherited

Output file.

Definition at line 633 of file plotter.h.

Referenced by DXF_PLOTTER::Arc(), SVG_PLOTTER::Arc(), Arc(), SVG_PLOTTER::BezierCurve(), HPGL_PLOTTER::Circle(), DXF_PLOTTER::Circle(), Circle(), SVG_PLOTTER::Circle(), GERBER_PLOTTER::ClearAllAttributes(), GERBER_PLOTTER::clearNetAttribute(), PDF_PLOTTER::ClosePage(), PDF_PLOTTER::closePdfObject(), PDF_PLOTTER::closePdfStream(), GERBER_PLOTTER::emitDcode(), PDF_PLOTTER::emitGoToAction(), PDF_PLOTTER::emitOutline(), PDF_PLOTTER::emitOutlineNode(), emitSetRGBColor(), SVG_PLOTTER::EndBlock(), DXF_PLOTTER::EndPlot(), GERBER_PLOTTER::EndPlot(), HPGL_PLOTTER::EndPlot(), EndPlot(), PDF_PLOTTER::EndPlot(), SVG_PLOTTER::EndPlot(), HPGL_PLOTTER::FlashPadCircle(), DXF_PLOTTER::FlashPadCircle(), GERBER_PLOTTER::FlashPadOval(), HPGL_PLOTTER::FlashPadOval(), PSLIKE_PLOTTER::FlashPadOval(), DXF_PLOTTER::FlashPadOval(), GERBER_PLOTTER::FlashPadRect(), DXF_PLOTTER::FlashPadRect(), GERBER_PLOTTER::FlashPadRoundRect(), DXF_PLOTTER::FlashPadTrapez(), GERBER_PLOTTER::formatNetAttribute(), PLOTTER::OpenFile(), PDF_PLOTTER::OpenFile(), DXF_PLOTTER::PenTo(), GERBER_PLOTTER::PenTo(), HPGL_PLOTTER::PenTo(), PenTo(), SVG_PLOTTER::PenTo(), GERBER_PLOTTER::plotArc(), GERBER_PLOTTER::PlotGerberRegion(), PlotImage(), SVG_PLOTTER::PlotImage(), GERBER_PLOTTER::PlotPoly(), PlotPoly(), SVG_PLOTTER::PlotPoly(), GERBER_PLOTTER::plotRoundRectAsRegion(), PLOTTER::PLOTTER(), HPGL_PLOTTER::Rect(), DXF_PLOTTER::Rect(), Rect(), SVG_PLOTTER::Rect(), GERBER_PLOTTER::selectAperture(), SetCurrentLineWidth(), SetDash(), GERBER_PLOTTER::SetLayerPolarity(), SVG_PLOTTER::setSVGPlotStyle(), SetViewport(), SVG_PLOTTER::StartBlock(), PDF_PLOTTER::StartPage(), PDF_PLOTTER::startPdfObject(), PDF_PLOTTER::startPdfStream(), DXF_PLOTTER::StartPlot(), HPGL_PLOTTER::StartPlot(), StartPlot(), SVG_PLOTTER::StartPlot(), PDF_PLOTTER::StartPlot(), GERBER_PLOTTER::StartPlot(), DXF_PLOTTER::Text(), Text(), SVG_PLOTTER::Text(), HPGL_PLOTTER::ThickSegment(), GERBER_PLOTTER::writeApertureList(), and PLOTTER::~PLOTTER().

◆ m_pageInfo

◆ m_paperSize

◆ m_penLastpos

VECTOR2I PLOTTER::m_penLastpos
protectedinherited

◆ m_penState

char PLOTTER::m_penState
protectedinherited

◆ m_plotMirror

◆ m_plotOffset

◆ m_plotScale

◆ m_renderSettings

◆ m_textMode

PLOT_TEXT_MODE PSLIKE_PLOTTER::m_textMode
protectedinherited

How to draw text.

Definition at line 151 of file plotters_pslike.h.

Referenced by PS_PLOTTER(), PSLIKE_PLOTTER::SetTextMode(), and Text().

◆ m_title

wxString PLOTTER::m_title
protectedinherited

Definition at line 644 of file plotter.h.

Referenced by PDF_PLOTTER::EndPlot(), PLOTTER::SetTitle(), and StartPlot().

◆ m_yaxisReversed

bool PLOTTER::m_yaxisReversed
protectedinherited

◆ MARKER_COUNT

const unsigned PLOTTER::MARKER_COUNT = 58
staticinherited

Draw a marker (used for the drill map).

Definition at line 466 of file plotter.h.

Referenced by PLOTTER::Marker().

◆ plotScaleAdjX

double PSLIKE_PLOTTER::plotScaleAdjX
protectedinherited

Fine user scale adjust ( = 1.0 if no correction)

Definition at line 148 of file plotters_pslike.h.

Referenced by PSLIKE_PLOTTER::SetScaleAdjust(), PDF_PLOTTER::StartPage(), and StartPlot().

◆ plotScaleAdjY

double PSLIKE_PLOTTER::plotScaleAdjY
protectedinherited

◆ postscriptTextAscent

const double PSLIKE_PLOTTER::postscriptTextAscent = 0.718
staticprotectedinherited

Height of the postscript font (from the AFM)

Definition at line 137 of file plotters_pslike.h.

Referenced by PSLIKE_PLOTTER::computeTextParameters(), PSLIKE_PLOTTER::postscriptOverlinePositions(), and PSLIKE_PLOTTER::returnPostscriptTextWidth().

◆ USE_DEFAULT_LINE_WIDTH


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