KiCad PCB EDA Suite
All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Modules Pages Concepts
SVG_plotter.cpp
Go to the documentation of this file.
1/*
2 * This program source code file is part of KiCad, a free EDA CAD application.
3 *
4 * Copyright (C) 2020 Jean-Pierre Charras, jp.charras at wanadoo.fr
5 * Copyright (C) 1992-2024 KiCad Developers, see AUTHORS.txt for contributors.
6 *
7 * This program is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU General Public License
9 * as published by the Free Software Foundation; either version 2
10 * of the License, or (at your option) any later version.
11 *
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
16 *
17 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, you may find one here:
19 * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
20 * or you may search the http://www.gnu.org website for the version 2 license,
21 * or you may write to the Free Software Foundation, Inc.,
22 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
23 */
24
25/* Some info on basic items SVG format, used here:
26 * The root element of all SVG files is the <svg> element.
27 *
28 * The <g> element is used to group SVG shapes together.
29 * Once grouped you can transform the whole group of shapes as if it was a single shape.
30 * This is an advantage compared to a nested <svg> element
31 * which cannot be the target of transformation by itself.
32 *
33 * The <rect> element represents a rectangle.
34 * Using this element you can draw rectangles of various width, height,
35 * with different stroke (outline) and fill colors, with sharp or rounded corners etc.
36 *
37 * <svg xmlns="http://www.w3.org/2000/svg"
38 * xmlns:xlink="http://www.w3.org/1999/xlink">
39 *
40 * <rect x="10" y="10" height="100" width="100"
41 * style="stroke:#006600; fill: #00cc00"/>
42 *
43 * </svg>
44 *
45 * The <circle> element is used to draw circles.
46 * <circle cx="40" cy="40" r="24" style="stroke:#006600; fill:#00cc00"/>
47 *
48 * The <ellipse> element is used to draw ellipses.
49 * An ellipse is a circle that does not have equal height and width.
50 * Its radius in the x and y directions are different, in other words.
51 * <ellipse cx="40" cy="40" rx="30" ry="15"
52 * style="stroke:#006600; fill:#00cc00"/>
53 *
54 * The <line> element is used to draw lines.
55 *
56 * <line x1="0" y1="10" x2="0" y2="100" style="stroke:#006600;"/>
57 * <line x1="10" y1="10" x2="100" y2="100" style="stroke:#006600;"/>
58 *
59 * The <polyline> element is used to draw multiple connected lines
60 * Here is a simple example:
61 *
62 * <polyline points="0,0 30,0 15,30" style="stroke:#006600;"/>
63 *
64 * The <polygon> element is used to draw with multiple (3 or more) sides / edges.
65 * Here is a simple example:
66 *
67 * <polygon points="0,0 50,0 25,50" style="stroke:#660000; fill:#cc3333;"/>
68 *
69 * The <path> element is used to draw advanced shapes combined from lines and arcs,
70 * with or without fill.
71 * It is probably the most advanced and versatile SVG shape of them all.
72 * It is probably also the hardest element to master.
73 * <path d="M50,50
74 * A30,30 0 0,1 35,20
75 * L100,100
76 * M110,110
77 * L100,0"
78 * style="stroke:#660000; fill:none;"/>
79 *
80 * Draw an elliptic arc: it is one of basic path command:
81 * <path d="M(startx,starty) A(radiusx,radiusy)
82 * rotation-axe-x
83 * flag_arc_large,flag_sweep endx,endy">
84 * flag_arc_large: 0 = small arc > 180 deg, 1 = large arc > 180 deg
85 * flag_sweep : 0 = CCW, 1 = CW
86 * The center of ellipse is automatically calculated.
87 */
88
89#include <core/base64.h>
90#include <eda_shape.h>
91#include <string_utils.h>
92#include <font/font.h>
93#include <macros.h>
94#include <trigo.h>
95
96#include <cstdint>
97#include <wx/mstream.h>
98
100
101// Note:
102// During tests, we (JPC) found issues when the coordinates used 6 digits in mantissa
103// especially for stroke-width using very small (but not null) values < 0.00001 mm
104// So to avoid this king of issue, we are using 4 digits in mantissa
105// The resolution (m_precision ) is 0.1 micron, that looks enougt for a SVG file
106
112static wxString XmlEsc( const wxString& aStr, bool isAttribute = false )
113{
114 wxString escaped;
115
116 escaped.reserve( aStr.length() );
117
118 for( wxString::const_iterator it = aStr.begin(); it != aStr.end(); ++it )
119 {
120 const wxChar c = *it;
121
122 switch( c )
123 {
124 case wxS( '<' ):
125 escaped.append( wxS( "&lt;" ) );
126 break;
127 case wxS( '>' ):
128 escaped.append( wxS( "&gt;" ) );
129 break;
130 case wxS( '&' ):
131 escaped.append( wxS( "&amp;" ) );
132 break;
133 case wxS( '\r' ):
134 escaped.append( wxS( "&#xD;" ) );
135 break;
136 default:
137 if( isAttribute )
138 {
139 switch( c )
140 {
141 case wxS( '"' ):
142 escaped.append( wxS( "&quot;" ) );
143 break;
144 case wxS( '\t' ):
145 escaped.append( wxS( "&#x9;" ) );
146 break;
147 case wxS( '\n' ):
148 escaped.append( wxS( "&#xA;" ));
149 break;
150 default:
151 escaped.append(c);
152 }
153 }
154 else
155 {
156 escaped.append(c);
157 }
158 }
159 }
160
161 return escaped;
162}
163
164
166 PSLIKE_PLOTTER( aProject )
167{
168 m_graphics_changed = true;
169 SetTextMode( PLOT_TEXT_MODE::STROKE );
170 m_fillMode = FILL_T::NO_FILL; // or FILLED_SHAPE or FILLED_WITH_BG_BODYCOLOR
171 m_pen_rgb_color = 0; // current color value (black)
172 m_brush_rgb_color = 0; // current color value with alpha(black)
173 m_brush_alpha = 1.0;
174 m_dashed = LINE_STYLE::SOLID;
175 m_precision = 4; // default: 4 digits in mantissa.
176}
177
178
179void SVG_PLOTTER::SetViewport( const VECTOR2I& aOffset, double aIusPerDecimil,
180 double aScale, bool aMirror )
181{
182 m_plotMirror = aMirror;
183 m_yaxisReversed = true; // unlike other plotters, SVG has Y axis reversed
184 m_plotOffset = aOffset;
185 m_plotScale = aScale;
186 m_IUsPerDecimil = aIusPerDecimil;
187
188 // Compute the paper size in IUs. for historical reasons the page size is in mils
190 m_paperSize.x *= 10.0 * aIusPerDecimil;
191 m_paperSize.y *= 10.0 * aIusPerDecimil;
192
193 // gives now a default value to iuPerDeviceUnit (because the units of the caller is now known)
194 double iusPerMM = m_IUsPerDecimil / 2.54 * 1000;
195 m_iuPerDeviceUnit = 1 / iusPerMM;
196
198}
199
200
201void SVG_PLOTTER::SetSvgCoordinatesFormat( unsigned aPrecision )
202{
203 // Only number of digits in mantissa are adjustable.
204 // SVG units are always mm
205 m_precision = aPrecision;
206}
207
208
210{
211 if( m_fillMode != fill )
212 {
213 m_graphics_changed = true;
214 m_fillMode = fill;
215 }
216}
217
218
219void SVG_PLOTTER::setSVGPlotStyle( int aLineWidth, bool aIsGroup, const std::string& aExtraStyle )
220{
221 if( aIsGroup )
222 fputs( "</g>\n<g ", m_outputFile );
223
224 fputs( "style=\"", m_outputFile );
225
226 if( m_fillMode == FILL_T::NO_FILL )
227 {
228 fputs( "fill:none; ", m_outputFile );
229 }
230 else
231 {
232 // output the background fill color
233 fprintf( m_outputFile, "fill:#%6.6lX; ", m_brush_rgb_color );
234
235 switch( m_fillMode )
236 {
237 case FILL_T::FILLED_SHAPE:
238 case FILL_T::FILLED_WITH_BG_BODYCOLOR:
239 case FILL_T::FILLED_WITH_COLOR:
240 fprintf( m_outputFile, "fill-opacity:%.*f; ", m_precision, m_brush_alpha );
241 break;
242 default: break;
243 }
244 }
245
246 double pen_w = userToDeviceSize( aLineWidth );
247
248 if( pen_w <= 0 )
249 {
250 fputs( "stroke:none;", m_outputFile );
251 }
252 else
253 {
254 // Fix a strange issue found in Inkscape: aWidth < 100 nm create issues on degrouping objects
255 // So we use only 4 digits in mantissa for stroke-width.
256 // TODO: perhaps used only 3 or 4 digits in mantissa for all values in mm, because some
257 // issues were previously reported reported when using nm as integer units
258
259 fprintf( m_outputFile, "\nstroke:#%6.6lX; stroke-width:%.*f; stroke-opacity:1; \n",
261 fputs( "stroke-linecap:round; stroke-linejoin:round;", m_outputFile );
262
263 //set any extra attributes for non-solid lines
264 switch( m_dashed )
265 {
266 case LINE_STYLE::DASH:
267 fprintf( m_outputFile, "stroke-dasharray:%.*f,%.*f;", m_precision,
268 GetDashMarkLenIU( aLineWidth ), m_precision, GetDashGapLenIU( aLineWidth ) );
269 break;
270
271 case LINE_STYLE::DOT:
272 fprintf( m_outputFile, "stroke-dasharray:%f,%f;", GetDotMarkLenIU( aLineWidth ),
273 GetDashGapLenIU( aLineWidth ) );
274 break;
275
276 case LINE_STYLE::DASHDOT:
277 fprintf( m_outputFile, "stroke-dasharray:%f,%f,%f,%f;", GetDashMarkLenIU( aLineWidth ),
278 GetDashGapLenIU( aLineWidth ), GetDotMarkLenIU( aLineWidth ),
279 GetDashGapLenIU( aLineWidth ) );
280 break;
281
282 case LINE_STYLE::DASHDOTDOT:
283 fprintf( m_outputFile, "stroke-dasharray:%f,%f,%f,%f,%f,%f;",
284 GetDashMarkLenIU( aLineWidth ), GetDashGapLenIU( aLineWidth ),
285 GetDotMarkLenIU( aLineWidth ), GetDashGapLenIU( aLineWidth ),
286 GetDotMarkLenIU( aLineWidth ), GetDashGapLenIU( aLineWidth ) );
287 break;
288
289 case LINE_STYLE::DEFAULT:
290 case LINE_STYLE::SOLID:
291 default:
292 //do nothing
293 break;
294 }
295 }
296
297 if( aExtraStyle.length() )
298 fputs( aExtraStyle.c_str(), m_outputFile );
299
300 fputs( "\"", m_outputFile );
301
302 if( aIsGroup )
303 {
304 fputs( ">", m_outputFile );
305 m_graphics_changed = false;
306 }
307
308 fputs( "\n", m_outputFile );
309}
310
311
312void SVG_PLOTTER::SetCurrentLineWidth( int aWidth, void* aData )
313{
314 if( aWidth == DO_NOT_SET_LINE_WIDTH )
315 return;
316 else if( aWidth == USE_DEFAULT_LINE_WIDTH )
318
319 // Note: aWidth == 0 is fine: used for filled shapes with no outline thickness
320
321 wxASSERT_MSG( aWidth >= 0, "Plotter called to set negative pen width" );
322
323 if( aWidth != m_currentPenWidth )
324 {
325 m_graphics_changed = true;
326 m_currentPenWidth = aWidth;
327 }
328}
329
330
331void SVG_PLOTTER::StartBlock( void* aData )
332{
333 // We can't use <g></g> for blocks because we're already using it for graphics context, and
334 // our graphics context handling is lazy (ie: it leaves the last group open until the context
335 // changes).
336}
337
338
339void SVG_PLOTTER::EndBlock( void* aData )
340{
341}
342
343
344void SVG_PLOTTER::emitSetRGBColor( double r, double g, double b, double a )
345{
346 int red = (int) ( 255.0 * r );
347 int green = (int) ( 255.0 * g );
348 int blue = (int) ( 255.0 * b );
349 long rgb_color = (red << 16) | (green << 8) | blue;
350
351 if( m_pen_rgb_color != rgb_color || m_brush_alpha != a )
352 {
353 m_graphics_changed = true;
354 m_pen_rgb_color = rgb_color;
355
356 // Currently, use the same color for brush and pen (i.e. to draw and fill a contour).
357 m_brush_rgb_color = rgb_color;
358 m_brush_alpha = a;
359 }
360}
361
362
363void SVG_PLOTTER::SetDash( int aLineWidth, LINE_STYLE aLineStyle )
364{
365 if( m_dashed != aLineStyle )
366 {
367 m_graphics_changed = true;
368 m_dashed = aLineStyle;
369 }
370}
371
372
373void SVG_PLOTTER::Rect( const VECTOR2I& p1, const VECTOR2I& p2, FILL_T fill, int width )
374{
375 BOX2I rect( p1, VECTOR2I( p2.x - p1.x, p2.y - p1.y ) );
376 rect.Normalize();
377
378 VECTOR2D org_dev = userToDeviceCoordinates( rect.GetOrigin() );
379 VECTOR2D end_dev = userToDeviceCoordinates( rect.GetEnd() );
380 VECTOR2D size_dev = end_dev - org_dev;
381
382 // Ensure size of rect in device coordinates is > 0
383 // I don't know if this is a SVG issue or a Inkscape issue, but
384 // Inkscape has problems with negative or null values for width and/or height, so avoid them
385 BOX2D rect_dev( org_dev, size_dev );
386 rect_dev.Normalize();
387
388 setFillMode( fill );
389 SetCurrentLineWidth( width );
390
393
394 // Rectangles having a 0 size value for height or width are just not drawn on Inkscape,
395 // so use a line when happens.
396 if( rect_dev.GetSize().x == 0.0 || rect_dev.GetSize().y == 0.0 ) // Draw a line
397 {
398 fprintf( m_outputFile,
399 "<line x1=\"%.*f\" y1=\"%.*f\" x2=\"%.*f\" y2=\"%.*f\" />\n",
400 m_precision, rect_dev.GetPosition().x,
401 m_precision, rect_dev.GetPosition().y,
402 m_precision, rect_dev.GetEnd().x,
403 m_precision, rect_dev.GetEnd().y );
404 }
405 else
406 {
407 fprintf( m_outputFile,
408 "<rect x=\"%f\" y=\"%f\" width=\"%f\" height=\"%f\" rx=\"%f\" />\n",
409 rect_dev.GetPosition().x,
410 rect_dev.GetPosition().y,
411 rect_dev.GetSize().x,
412 rect_dev.GetSize().y,
413 0.0 /* radius of rounded corners */ );
414 }
415}
416
417
418void SVG_PLOTTER::Circle( const VECTOR2I& pos, int diametre, FILL_T fill, int width )
419{
420 VECTOR2D pos_dev = userToDeviceCoordinates( pos );
421 double radius = userToDeviceSize( diametre / 2.0 );
422
423 setFillMode( fill );
424 SetCurrentLineWidth( width );
425
428
429 // If diameter is less than width, switch to filled mode
430 if( fill == FILL_T::NO_FILL && diametre < width )
431 {
432 setFillMode( FILL_T::FILLED_SHAPE );
434
435 radius = userToDeviceSize( ( diametre / 2.0 ) + ( width / 2.0 ) );
436 }
437
438 fprintf( m_outputFile,
439 "<circle cx=\"%.*f\" cy=\"%.*f\" r=\"%.*f\" /> \n",
440 m_precision, pos_dev.x,
441 m_precision, pos_dev.y,
442 m_precision, radius );
443}
444
445
446void SVG_PLOTTER::Arc( const VECTOR2D& aCenter, const EDA_ANGLE& aStartAngle,
447 const EDA_ANGLE& aAngle, double aRadius, FILL_T aFill, int aWidth )
448{
449 /* Draws an arc of a circle, centered on (xc,yc), with starting point (x1, y1) and ending
450 * at (x2, y2). The current pen is used for the outline and the current brush for filling
451 * the shape.
452 *
453 * The arc is drawn in an anticlockwise direction from the start point to the end point.
454 */
455
456 if( aRadius <= 0 )
457 {
458 Circle( aCenter, aWidth, FILL_T::FILLED_SHAPE, 0 );
459 return;
460 }
461
462 EDA_ANGLE startAngle = -aStartAngle;
463 EDA_ANGLE endAngle = startAngle - aAngle;
464
465 if( endAngle < startAngle )
466 std::swap( startAngle, endAngle );
467
468 // Calculate start point.
469 VECTOR2D centre_device = userToDeviceCoordinates( aCenter );
470 double radius_device = userToDeviceSize( aRadius );
471
472 if( m_plotMirror )
473 {
475 {
476 std::swap( startAngle, endAngle );
477 startAngle = ANGLE_180 - startAngle;
478 endAngle = ANGLE_180 - endAngle;
479 }
480 else
481 {
482 startAngle = -startAngle;
483 endAngle = -endAngle;
484 }
485 }
486
487 VECTOR2D start;
488 start.x = radius_device;
489 RotatePoint( start, startAngle );
490 VECTOR2D end;
491 end.x = radius_device;
492 RotatePoint( end, endAngle );
493 start += centre_device;
494 end += centre_device;
495
496 double theta1 = startAngle.AsRadians();
497
498 if( theta1 < 0 )
499 theta1 = theta1 + M_PI * 2;
500
501 double theta2 = endAngle.AsRadians();
502
503 if( theta2 < 0 )
504 theta2 = theta2 + M_PI * 2;
505
506 if( theta2 < theta1 )
507 theta2 = theta2 + M_PI * 2;
508
509 int flg_arc = 0; // flag for large or small arc. 0 means less than 180 degrees
510
511 if( fabs( theta2 - theta1 ) > M_PI )
512 flg_arc = 1;
513
514 int flg_sweep = 0; // flag for sweep always 0
515
516 // Draw a single arc: an arc is one of 3 curve commands (2 other are 2 bezier curves)
517 // params are start point, radius1, radius2, X axe rotation,
518 // flag arc size (0 = small arc > 180 deg, 1 = large arc > 180 deg),
519 // sweep arc ( 0 = CCW, 1 = CW),
520 // end point
521 if( aFill != FILL_T::NO_FILL )
522 {
523 // Filled arcs (in Eeschema) consist of the pie wedge and a stroke only on the arc
524 // This needs to be drawn in two steps.
525 setFillMode( aFill );
527
530
531 fprintf( m_outputFile, "<path d=\"M%.*f %.*f A%.*f %.*f 0.0 %d %d %.*f %.*f L %.*f %.*f Z\" />\n",
532 m_precision, start.x,
533 m_precision, start.y,
534 m_precision, radius_device,
535 m_precision, radius_device,
536 flg_arc,
537 flg_sweep,
538 m_precision, end.x,
539 m_precision, end.y,
540 m_precision, centre_device.x,
541 m_precision, centre_device.y );
542 }
543
544 setFillMode( FILL_T::NO_FILL );
545 SetCurrentLineWidth( aWidth );
546
549
550 fprintf( m_outputFile,
551 "<path d=\"M%.*f %.*f A%.*f %.*f 0.0 %d %d %.*f %.*f\" />\n",
552 m_precision, start.x,
553 m_precision, start.y,
554 m_precision, radius_device,
555 m_precision, radius_device,
556 flg_arc,
557 flg_sweep,
558 m_precision, end.x,
559 m_precision, end.y );
560}
561
562
563void SVG_PLOTTER::BezierCurve( const VECTOR2I& aStart, const VECTOR2I& aControl1,
564 const VECTOR2I& aControl2, const VECTOR2I& aEnd,
565 int aTolerance, int aLineThickness )
566{
567#if 1
568 setFillMode( FILL_T::NO_FILL );
569 SetCurrentLineWidth( aLineThickness );
570
573
574 VECTOR2D start = userToDeviceCoordinates( aStart );
575 VECTOR2D ctrl1 = userToDeviceCoordinates( aControl1 );
576 VECTOR2D ctrl2 = userToDeviceCoordinates( aControl2 );
577 VECTOR2D end = userToDeviceCoordinates( aEnd );
578
579 // Generate a cubic curve: start point and 3 other control points.
580 fprintf( m_outputFile,
581 "<path d=\"M%.*f,%.*f C%.*f,%.*f %.*f,%.*f %.*f,%.*f\" />\n",
582 m_precision, start.x,
583 m_precision, start.y,
584 m_precision, ctrl1.x,
585 m_precision, ctrl1.y,
586 m_precision, ctrl2.x,
587 m_precision, ctrl2.y,
588 m_precision, end.x,
589 m_precision, end.y );
590#else
591 PLOTTER::BezierCurve( aStart, aControl1, aControl2, aEnd, aTolerance, aLineThickness );
592#endif
593}
594
595
596void SVG_PLOTTER::PlotPoly( const std::vector<VECTOR2I>& aCornerList, FILL_T aFill,
597 int aWidth, void* aData )
598{
599 if( aCornerList.size() <= 1 )
600 return;
601
602 setFillMode( aFill );
603 SetCurrentLineWidth( aWidth );
604 fprintf( m_outputFile, "<path ");
605
606 switch( aFill )
607 {
608 case FILL_T::NO_FILL:
609 setSVGPlotStyle( aWidth, false, "fill:none" );
610 break;
611
612 case FILL_T::FILLED_WITH_BG_BODYCOLOR:
613 case FILL_T::FILLED_SHAPE:
614 case FILL_T::FILLED_WITH_COLOR:
615 setSVGPlotStyle( aWidth, false, "fill-rule:evenodd;" );
616 break;
617 }
618
619 VECTOR2D pos = userToDeviceCoordinates( aCornerList[0] );
620 fprintf( m_outputFile,
621 "d=\"M %.*f,%.*f\n",
622 m_precision, pos.x,
623 m_precision, pos.y );
624
625 for( unsigned ii = 1; ii < aCornerList.size() - 1; ii++ )
626 {
627 pos = userToDeviceCoordinates( aCornerList[ii] );
628 fprintf( m_outputFile,
629 "%.*f,%.*f\n",
630 m_precision, pos.x,
631 m_precision, pos.y );
632 }
633
634 // If the corner list ends where it begins, then close the poly
635 if( aCornerList.front() == aCornerList.back() )
636 {
637 fprintf( m_outputFile, "Z\" /> \n" );
638 }
639 else
640 {
641 pos = userToDeviceCoordinates( aCornerList.back() );
642 fprintf( m_outputFile,
643 "%.*f,%.*f\n\" /> \n",
644 m_precision, pos.x,
645 m_precision, pos.y );
646 }
647}
648
649
650void SVG_PLOTTER::PlotImage( const wxImage& aImage, const VECTOR2I& aPos, double aScaleFactor )
651{
652 VECTOR2I pix_size( aImage.GetWidth(), aImage.GetHeight() );
653
654 // Requested size (in IUs)
655 VECTOR2D drawsize( aScaleFactor * pix_size.x, aScaleFactor * pix_size.y );
656
657 // calculate the bitmap start position
658 VECTOR2I start( aPos.x - drawsize.x / 2, aPos.y - drawsize.y / 2 );
659
660 // Rectangles having a 0 size value for height or width are just not drawn on Inkscape,
661 // so use a line when happens.
662 if( drawsize.x == 0.0 || drawsize.y == 0.0 ) // Draw a line
663 {
664 PLOTTER::PlotImage( aImage, aPos, aScaleFactor );
665 }
666 else
667 {
668 wxMemoryOutputStream img_stream;
669
670 if( m_colorMode )
671 {
672 aImage.SaveFile( img_stream, wxBITMAP_TYPE_PNG );
673 }
674 else // Plot in B&W
675 {
676 wxImage image = aImage.ConvertToGreyscale();
677 image.SaveFile( img_stream, wxBITMAP_TYPE_PNG );
678 }
679
680 size_t input_len = img_stream.GetOutputStreamBuffer()->GetBufferSize();
681 std::vector<uint8_t> buffer( input_len );
682 std::vector<uint8_t> encoded;
683
684 img_stream.CopyTo( buffer.data(), buffer.size() );
685 base64::encode( buffer, encoded );
686
687 fprintf( m_outputFile,
688 "<image x=\"%f\" y=\"%f\" xlink:href=\"data:image/png;base64,",
689 userToDeviceSize( start.x ),
690 userToDeviceSize( start.y ) );
691
692 for( size_t i = 0; i < encoded.size(); i++ )
693 {
694 fprintf( m_outputFile, "%c", static_cast<char>( encoded[i] ) );
695
696 if( ( i % 64 ) == 63 )
697 fprintf( m_outputFile, "\n" );
698 }
699
700 fprintf( m_outputFile,
701 "\"\npreserveAspectRatio=\"none\" width=\"%.*f\" height=\"%.*f\" />",
703 userToDeviceSize( drawsize.x ),
705 userToDeviceSize( drawsize.y ) );
706 }
707}
708
709
710void SVG_PLOTTER::PenTo( const VECTOR2I& pos, char plume )
711{
712 if( plume == 'Z' )
713 {
714 if( m_penState != 'Z' )
715 {
716 fputs( "\" />\n", m_outputFile );
717 m_penState = 'Z';
718 m_penLastpos.x = -1;
719 m_penLastpos.y = -1;
720 }
721
722 return;
723 }
724
725 if( m_penState == 'Z' ) // here plume = 'D' or 'U'
726 {
727 VECTOR2D pos_dev = userToDeviceCoordinates( pos );
728
729 // Ensure we do not use a fill mode when moving the pen,
730 // in SVG mode (i;e. we are plotting only basic lines, not a filled area
731 if( m_fillMode != FILL_T::NO_FILL )
732 setFillMode( FILL_T::NO_FILL );
733
736
737 fprintf( m_outputFile, "<path d=\"M%.*f %.*f\n",
738 m_precision, pos_dev.x,
739 m_precision, pos_dev.y );
740 }
741 else if( m_penState != plume || pos != m_penLastpos )
742 {
745
746 VECTOR2D pos_dev = userToDeviceCoordinates( pos );
747
748 fprintf( m_outputFile, "L%.*f %.*f\n",
749 m_precision, pos_dev.x,
750 m_precision, pos_dev.y );
751 }
752
753 m_penState = plume;
754 m_penLastpos = pos;
755}
756
757
758bool SVG_PLOTTER::StartPlot( const wxString& aPageNumber )
759{
760 wxASSERT( m_outputFile );
761
762 static const char* header[] =
763 {
764 "<?xml version=\"1.0\" standalone=\"no\"?>\n",
765 " <!DOCTYPE svg PUBLIC \"-//W3C//DTD SVG 1.1//EN\" \n",
766 " \"http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd\"> \n",
767 "<svg\n"
768 " xmlns:svg=\"http://www.w3.org/2000/svg\"\n"
769 " xmlns=\"http://www.w3.org/2000/svg\"\n",
770 " xmlns:xlink=\"http://www.w3.org/1999/xlink\"\n",
771 " version=\"1.1\"\n",
772 nullptr
773 };
774
775 // Write header.
776 for( int ii = 0; header[ii] != nullptr; ii++ )
777 {
778 fputs( header[ii], m_outputFile );
779 }
780
781 // Write viewport pos and size
782 VECTOR2D origin; // TODO set to actual value
783 fprintf( m_outputFile, " width=\"%.*fmm\" height=\"%.*fmm\" viewBox=\"%.*f %.*f %.*f %.*f\">\n",
784 m_precision, (double) m_paperSize.x / m_IUsPerDecimil * 2.54 / 1000,
785 m_precision, (double) m_paperSize.y / m_IUsPerDecimil * 2.54 / 1000,
786 m_precision, origin.x, m_precision, origin.y,
789
790 // Write title
791 char date_buf[250];
792 time_t ltime = time( nullptr );
793 strftime( date_buf, 250, "%Y/%m/%d %H:%M:%S", localtime( &ltime ) );
794
795 fprintf( m_outputFile,
796 "<title>SVG Image created as %s date %s </title>\n",
797 TO_UTF8( XmlEsc( wxFileName( m_filename ).GetFullName() ) ),
798 date_buf );
799
800 // End of header
801 fprintf( m_outputFile,
802 " <desc>Image generated by %s </desc>\n",
803 TO_UTF8( XmlEsc( m_creator ) ) );
804
805 // output the pen and brush color (RVB values in hex) and opacity
806 double opacity = 1.0; // 0.0 (transparent to 1.0 (solid)
807 fprintf( m_outputFile,
808 "<g style=\"fill:#%6.6lX; fill-opacity:%.*f;stroke:#%6.6lX; stroke-opacity:%.*f;\n",
814 opacity );
815
816 // output the pen cap and line joint
817 fputs( "stroke-linecap:round; stroke-linejoin:round;\"\n", m_outputFile );
818 fputs( " transform=\"translate(0 0) scale(1 1)\">\n", m_outputFile );
819 return true;
820}
821
822
824{
825 fputs( "</g> \n</svg>\n", m_outputFile );
826 fclose( m_outputFile );
827 m_outputFile = nullptr;
828
829 return true;
830}
831
832
833void SVG_PLOTTER::Text( const VECTOR2I& aPos,
834 const COLOR4D& aColor,
835 const wxString& aText,
836 const EDA_ANGLE& aOrient,
837 const VECTOR2I& aSize,
838 enum GR_TEXT_H_ALIGN_T aH_justify,
839 enum GR_TEXT_V_ALIGN_T aV_justify,
840 int aWidth,
841 bool aItalic,
842 bool aBold,
843 bool aMultilineAllowed,
844 KIFONT::FONT* aFont,
845 const KIFONT::METRICS& aFontMetrics,
846 void* aData )
847{
848 setFillMode( FILL_T::NO_FILL );
849 SetColor( aColor );
850 SetCurrentLineWidth( aWidth );
851
854
855 VECTOR2I text_pos = aPos;
856 const char* hjust = "start";
857
858 switch( aH_justify )
859 {
860 case GR_TEXT_H_ALIGN_CENTER: hjust = "middle"; break;
861 case GR_TEXT_H_ALIGN_RIGHT: hjust = "end"; break;
862 case GR_TEXT_H_ALIGN_LEFT: hjust = "start"; break;
864 wxFAIL_MSG( wxT( "Indeterminate state legal only in dialogs." ) );
865 break;
866 }
867
868 switch( aV_justify )
869 {
870 case GR_TEXT_V_ALIGN_CENTER: text_pos.y += aSize.y / 2; break;
871 case GR_TEXT_V_ALIGN_TOP: text_pos.y += aSize.y; break;
872 case GR_TEXT_V_ALIGN_BOTTOM: break;
874 wxFAIL_MSG( wxT( "Indeterminate state legal only in dialogs." ) );
875 break;
876 }
877
878 VECTOR2I text_size;
879
880 // aSize.x or aSize.y is < 0 for mirrored texts.
881 // The actual text size value is the absolute value
882 text_size.x = std::abs( GRTextWidth( aText, aFont, aSize, aWidth, aBold, aItalic, aFontMetrics ) );
883 text_size.y = std::abs( aSize.x * 4/3 ); // Hershey font height to em size conversion
884 VECTOR2D anchor_pos_dev = userToDeviceCoordinates( aPos );
885 VECTOR2D text_pos_dev = userToDeviceCoordinates( text_pos );
886 VECTOR2D sz_dev = userToDeviceSize( text_size );
887
888 // Output the text as a hidden string (opacity = 0). This allows WYSIWYG search to highlight
889 // a selection in approximately the right area. It also makes it easier for those that need
890 // to edit the text (as text) in subsequent processes.
891 {
892 if( !aOrient.IsZero() )
893 {
894 fprintf( m_outputFile,
895 "<g transform=\"rotate(%f %.*f %.*f)\">\n",
896 m_plotMirror ? aOrient.AsDegrees() : -aOrient.AsDegrees(),
898 anchor_pos_dev.x,
900 anchor_pos_dev.y );
901 }
902
903 fprintf( m_outputFile,
904 "<text x=\"%.*f\" y=\"%.*f\"\n",
906 text_pos_dev.x, m_precision,
907 text_pos_dev.y );
908
910 if( m_plotMirror != ( aSize.x < 0 ) )
911 {
912 fprintf( m_outputFile, "transform=\"scale(-1 1) translate(%f 0)\"\n",
913 -2 * text_pos_dev.x );
914 }
915
916 fprintf( m_outputFile,
917 "textLength=\"%.*f\" font-size=\"%.*f\" lengthAdjust=\"spacingAndGlyphs\"\n"
918 "text-anchor=\"%s\" opacity=\"0\" stroke-opacity=\"0\">%s</text>\n",
920 sz_dev.x,
922 sz_dev.y,
923 hjust,
924 TO_UTF8( XmlEsc( aText ) ) );
925
926 if( !aOrient.IsZero() )
927 fputs( "</g>\n", m_outputFile );
928 }
929
930 // Output the text again as graphics with a <desc> tag (for non-WYSIWYG search and for
931 // screen readers)
932 {
933 fprintf( m_outputFile,
934 "<g class=\"stroked-text\"><desc>%s</desc>\n",
935 TO_UTF8( XmlEsc( aText ) ) );
936
937 PLOTTER::Text( aPos, aColor, aText, aOrient, aSize, aH_justify, aV_justify, aWidth,
938 aItalic, aBold, aMultilineAllowed, aFont, aFontMetrics );
939
940 fputs( "</g>", m_outputFile );
941 }
942}
943
944
946 const COLOR4D& aColor,
947 const wxString& aText,
948 const TEXT_ATTRIBUTES& aAttributes,
949 KIFONT::FONT* aFont,
950 const KIFONT::METRICS& aFontMetrics,
951 void* aData )
952{
953 VECTOR2I size = aAttributes.m_Size;
954
955 if( aAttributes.m_Mirrored )
956 size.x = -size.x;
957
958 SVG_PLOTTER::Text( aPos, aColor, aText, aAttributes.m_Angle, size, aAttributes.m_Halign,
959 aAttributes.m_Valign, aAttributes.m_StrokeWidth, aAttributes.m_Italic,
960 aAttributes.m_Bold, aAttributes.m_Multiline, aFont, aFontMetrics, aData );
961}
static wxString XmlEsc(const wxString &aStr, bool isAttribute=false)
Translates '<' to "<", '>' to ">" and so on, according to the spec: http://www.w3....
constexpr const Vec & GetPosition() const
Definition: box2.h:211
constexpr const Vec GetEnd() const
Definition: box2.h:212
constexpr BOX2< Vec > & Normalize()
Ensure that the height and width are positive.
Definition: box2.h:146
constexpr const Vec & GetOrigin() const
Definition: box2.h:210
constexpr const SizeVec & GetSize() const
Definition: box2.h:206
double AsDegrees() const
Definition: eda_angle.h:113
bool IsZero() const
Definition: eda_angle.h:133
double AsRadians() const
Definition: eda_angle.h:117
FONT is an abstract base class for both outline and stroke fonts.
Definition: font.h:131
A color representation with 4 components: red, green, blue, alpha.
Definition: color4d.h:104
int GetDefaultPenWidth() const
const VECTOR2D & GetSizeMils() const
Definition: page_info.h:144
double GetDotMarkLenIU(int aLineWidth) const
Definition: plotter.cpp:132
virtual void PlotImage(const wxImage &aImage, const VECTOR2I &aPos, double aScaleFactor)
Only PostScript plotters can plot bitmaps.
Definition: plotter.cpp:259
double GetDashGapLenIU(int aLineWidth) const
Definition: plotter.cpp:144
bool m_mirrorIsHorizontal
Definition: plotter.h:658
PAGE_INFO m_pageInfo
Definition: plotter.h:676
bool m_plotMirror
Definition: plotter.h:656
static const int USE_DEFAULT_LINE_WIDTH
Definition: plotter.h:109
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...
Definition: plotter.cpp:230
bool m_yaxisReversed
Definition: plotter.h:659
double m_iuPerDeviceUnit
Definition: plotter.h:653
VECTOR2I m_plotOffset
Definition: plotter.h:655
VECTOR2I m_penLastpos
Definition: plotter.h:669
virtual VECTOR2D userToDeviceCoordinates(const VECTOR2I &aCoordinate)
Modify coordinates according to the orientation, scale factor, and offsets trace.
Definition: plotter.cpp:91
VECTOR2I m_paperSize
Definition: plotter.h:677
virtual VECTOR2D userToDeviceSize(const VECTOR2I &size)
Modify size according to the plotter scale factors (VECTOR2I version, returns a VECTOR2D).
Definition: plotter.cpp:116
char m_penState
Definition: plotter.h:668
wxString m_creator
Definition: plotter.h:671
int m_currentPenWidth
Definition: plotter.h:667
double m_plotScale
Plot scale - chosen by the user (even implicitly with 'fit in a4')
Definition: plotter.h:645
FILE * m_outputFile
Output file.
Definition: plotter.h:662
static const int DO_NOT_SET_LINE_WIDTH
Definition: plotter.h:108
RENDER_SETTINGS * m_renderSettings
Definition: plotter.h:681
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, const KIFONT::METRICS &aFontMetrics, void *aData=nullptr)
Draw text with the plotter.
Definition: plotter.cpp:692
double m_IUsPerDecimil
Definition: plotter.h:651
virtual int GetCurrentLineWidth() const
Definition: plotter.h:148
bool m_colorMode
Definition: plotter.h:665
double GetDashMarkLenIU(int aLineWidth) const
Definition: plotter.cpp:138
wxString m_filename
Definition: plotter.h:672
Container for project specific data.
Definition: project.h:64
The PSLIKE_PLOTTER class is an intermediate class to handle common routines for engines working more ...
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:63
virtual void SetTextMode(PLOT_TEXT_MODE mode) override
PS and PDF fully implement native text (for the Latin-1 subset)
virtual void emitSetRGBColor(double r, double g, double b, double a) override
Initialize m_pen_rgb_color from reduced values r, g ,b ( reduced values are 0.0 to 1....
virtual void PlotImage(const wxImage &aImage, const VECTOR2I &aPos, double aScaleFactor) override
PostScript-likes at the moment are the only plot engines supporting bitmaps.
unsigned m_precision
virtual bool StartPlot(const wxString &aPageNumber) override
Create SVG file header.
virtual void EndBlock(void *aData) override
Calling this function allows one to define the end of a group of drawing items the group is started b...
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 ).
virtual void SetViewport(const VECTOR2I &aOffset, double aIusPerDecimil, double aScale, bool aMirror) override
Set the plot offset and scaling for the current plot.
LINE_STYLE m_dashed
SVG_PLOTTER(const PROJECT *aProject=nullptr)
virtual void BezierCurve(const VECTOR2I &aStart, const VECTOR2I &aControl1, const VECTOR2I &aControl2, const VECTOR2I &aEnd, int aTolerance, int aLineThickness=USE_DEFAULT_LINE_WIDTH) override
Generic fallback: Cubic Bezier curve rendered as a polyline In KiCad the bezier curves have 4 control...
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, KIFONT::FONT *aFont, const KIFONT::METRICS &aFontMetrics, void *aData=nullptr) override
Draw text with the plotter.
double m_brush_alpha
virtual void Rect(const VECTOR2I &p1, const VECTOR2I &p2, FILL_T fill, int width=USE_DEFAULT_LINE_WIDTH) override
virtual void SetSvgCoordinatesFormat(unsigned aPrecision) override
Select SVG coordinate precision (number of digits needed for 1 mm ) (SVG plotter uses always metric u...
virtual bool EndPlot() override
void setSVGPlotStyle(int aLineWidth, bool aIsGroup=true, const std::string &aExtraStyle={})
Output the string which define pen and brush color, shape, transparency.
virtual void PlotText(const VECTOR2I &aPos, const COLOR4D &aColor, const wxString &aText, const TEXT_ATTRIBUTES &aAttributes, KIFONT::FONT *aFont, const KIFONT::METRICS &aFontMetrics, void *aData=nullptr) override
virtual void PenTo(const VECTOR2I &pos, char plume) override
Moveto/lineto primitive, moves the 'pen' to the specified direction.
long m_brush_rgb_color
virtual void Circle(const VECTOR2I &pos, int diametre, FILL_T fill, int width=USE_DEFAULT_LINE_WIDTH) override
bool m_graphics_changed
virtual void SetDash(int aLineWidth, LINE_STYLE aLineStyle) override
SVG supports dashed lines.
virtual void StartBlock(void *aData) override
Calling this function allows one to define the beginning of a group of drawing items (used in SVG for...
void setFillMode(FILL_T fill)
Prepare parameters for setSVGPlotStyle()
virtual void Arc(const VECTOR2D &aCenter, const EDA_ANGLE &aStartAngle, const EDA_ANGLE &aAngle, double aRadius, FILL_T aFill, int aWidth=USE_DEFAULT_LINE_WIDTH) override
virtual void SetCurrentLineWidth(int width, void *aData=nullptr) override
Set the current line width (in IUs) for the next plot.
GR_TEXT_H_ALIGN_T m_Halign
GR_TEXT_V_ALIGN_T m_Valign
static constexpr EDA_ANGLE ANGLE_180
Definition: eda_angle.h:405
FILL_T
Definition: eda_shape.h:56
int GRTextWidth(const wxString &aText, KIFONT::FONT *aFont, const VECTOR2I &aSize, int aThickness, bool aBold, bool aItalic, const KIFONT::METRICS &aFontMetrics)
Definition: gr_text.cpp:113
This file contains miscellaneous commonly used macros and functions.
void encode(const std::vector< uint8_t > &aInput, std::vector< uint8_t > &aOutput)
Definition: base64.cpp:76
EDA_ANGLE abs(const EDA_ANGLE &aAngle)
Definition: eda_angle.h:390
Plotting engines similar to ps (PostScript, Gerber, svg)
#define TO_UTF8(wxstring)
Convert a wxString to a UTF8 encoded C string for all wxWidgets build modes.
Definition: string_utils.h:398
LINE_STYLE
Dashed line types.
Definition: stroke_params.h:46
GR_TEXT_H_ALIGN_T
@ GR_TEXT_H_ALIGN_CENTER
@ GR_TEXT_H_ALIGN_RIGHT
@ GR_TEXT_H_ALIGN_LEFT
@ GR_TEXT_H_ALIGN_INDETERMINATE
GR_TEXT_V_ALIGN_T
@ GR_TEXT_V_ALIGN_BOTTOM
@ GR_TEXT_V_ALIGN_INDETERMINATE
@ GR_TEXT_V_ALIGN_CENTER
@ GR_TEXT_V_ALIGN_TOP
void RotatePoint(int *pX, int *pY, const EDA_ANGLE &aAngle)
Calculate the new point of coord coord pX, pY, for a rotation center 0, 0.
Definition: trigo.cpp:229
VECTOR2< int32_t > VECTOR2I
Definition: vector2d.h:691