dxf.c File Reference

---

Detailed Description

This file contains the DXF HID (Human Interface Device) exporter to generate a DXF file containing Xref's of components and a series of DXF files, one for every pcb layer.

The DXF exporter is based on the BOM and Gerber HID's.
I have copied the bom.c file and added portions from gerber.c and edited the used bits for DXF relevant code.

Author:

Copyright (C) 2007 by Bert Timmerman <bert.timmerman@xs4all.nl> for DXF relevant code.

Copyright (C) for BOM and Gerber HID parts by their authors.

---

Copyright Notices.

• This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
  
  This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  See the GNU General Public License for more details.
  
  You should have received a copy of the GNU General Public License along with this program; if not, write to:
  Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111 USA
  

• PCB, interactive printed circuit board design.
  Copyright (C) 1994,1995,1996 Thomas Nau.
  Copyright (C) 1997, 1998, 1999, 2000, 2001 Harry Eaton.
  For contact addresses for paper mail and e-mail see:
  http://sourceforge.net/projects/pcb

• Drawing eXchange Format (DXF)
  DXF is a defacto industry standard for the exchange of drawing files between various Computer Aided Drafting programs.
  DXF is designed by Autodesk(TM).
  For more details see:
  http://www.autodesk.com

---

Warning.

Some notes about Coordinate systems:

• PCB follows a "left handed" Cartesian Coordinate System.
  Positive X is right, positive Y is down.
  Angles are counter clockwise (CCW) in degrees, with 0 degrees being left (negative X-axis) and 90 degrees being down (positive Y-axis).
  
• AutoCAD DXF follows a "right handed" Cartesian Coordinate system.
  Positive X is right, positive Y is up.
  Angles are counter clockwise (CCW) in degrees, with 0 being right (positive X) and 90 being up (positive Y).
  
• PCB coordinates are ALWAYS in a (default) resolution of 1/100 mil (at the moment).
  
• Autocad coordinates are either in mil (default) or in mm (see checkbox in the DXF HID dialog).
  
• Lookup Wikipedia with keywords "Cartesian Coordinates" if you want more information on this subject.
  

Filled polygons are drawn with a hatch entity.
Elliptic arcs are drawn with an ellipse entity.
Successful importing the generated dxf files with these entities requires AutoCAD version R14 or higher, or any other mechanical CAD program with the same level of compatibility with regard to the DXF format.

---

Installation Notes.

The installation and subsequent use of the DXF HID requires recompilation of the pcb package with the pcb-dxf-HID package merged into pcb. This requires the following actions:

Todo:

• Untar and ungzip the pcb-dxf-HID.tar.gz file in the parent directory where the pcb directory lives.
  Typically this would require tar -xzf pcb-dxf-HID.tar.gz
  
  
• Edit the following entry in configure.ac in the "pcb" toplevel directory to apply the DXF hid.
  Something like this: (remember to use real [TAB] characters where needed !)
  

  AC_MSG_CHECKING([for which exporters to use])
  AC_ARG_WITH([exporters],
  [  --with-exporters=       Enable export devices: bom dxf gerber png ps [[default=bom dxf gerber png ps]]],
  [],[with_exporters=$hid_exporters])
  AC_MSG_RESULT([$with_exporters])
  for e in `echo $with_exporters | sed 's/,/ /g'`; do
      case " $hid_exporters " in
        *\ $e\ * )
          HIDLIST="$HIDLIST $e"
          ;;
   ) AC_MSG_ERROR([$e is not a valid exporter]) ;;
      esac
  done
  

  
  
• Edit the following or add entries in the pcb/src/Makefile.am for the DXF hid: (remember to use real [TAB] characters where needed !)
  
  

  EXTRA_LIBRARIES = \
          libgtk.a liblesstif.a libbatch.a \
          liblpr.a libgerber.a libbom.a libdxf.a libpng.a libps.a

  ...

  EXTRA_DIST= \
          check_icon.data \
          default_font \
          /hid/bom/hid.conf \
          /hid/dxf/hid.conf \
          /hid/gerber/hid.conf \
          ...

  ...
  
  libdxf_a_SOURCES = \
          hid/hidint.h \
          hid/dxf/dxf.c
  

  
  
• Run ./autogen.sh from the pcb/ toplevel directory.
• Run ./configure with the arguments that best fit to your needs.
• Run make
• Change to directory src
• Run ./pcb
• Load a pcb file.
• Export with File/Export Layout/dxf or any other exporter you want to export with.
• If all goes well, run make install from the toplevel directory if you want this version of pcb to be installed.
• Documentation of the DXF-HID is written for Doxygen (version >= 1.4.6).
  To (re)generate this Doxygen documentation, edit (if needed) and run doxygen dxf-dox-no-call-graphs.dox or doxygen dxf-dox-with-call-graphs.dox in the src/hid/dxf directory to create HTML, latex and other docs in the pcb/src/hid/dxf/doc directory.
• Please send remarks, bugs, improvements, relevant opinions to bert.timmerman@xs4all.nl or to the geda-dev mailing list.
• Donations to speed up the development of the gEDA suite best go to www.gedaconsulting.com.
• Have fun ;-)

---

The DXF HID function treeview.

The following function hierarchy, with the status of the functions in between [], exists:

• dxf_get_export_options [stable]
• dxf_do_export [stable]
  • dxf_get_export_options [stable]
  • dxf_export_xref_file [exp]
    • dxf_write_comment [stable]
    • dxf_write_header [stable]
      • dxf_write_header_metric_new [stable]
      • dxf_write_header_imperial_new [todo]
    • dxf_write_block_record [todo]
    • dxf_write_block [stable]
    • dxf_write_endsection [stable]
    • dxf_write_section [stable]
    • dxf_insert [stable]
    • dxf_write_eof [stable]
  • dxf_maybe_close_file [exp]
    • dxf_write_tail [todo]
    • dxf_write_tail_metric_new [todo]
    • dxf_write_tail_imperial_new [todo]
    • dxf_write_eof [stable]
• dxf_parse_arguments [stable]
• dxf_set_layer [exp]
  • dxf_maybe_close_file [stable]
  • dxf_write_header [stable]
    • dxf_write_header_metric_new [stable]
    • dxf_write_header_imperial_new [todo]
  • dxf_write_block_record [todo]
  • dxf_write_block [stable]
  • dxf_write_endsection [stable]
  • dxf_write_section [stable]
• dxf_make_gc [stable]
• dxf_destroy_gc [stable]
• dxf_use_mask [stable]
• dxf_set_color [stable]
• dxf_set_line_cap [stable]
• dxf_set_line_width [stable]
• dxf_draw_line [exp]
  • dxf_write_polyline [exp]
  • dxf_write_vertex [stable]
  • dxf_write_endseq [stable]
• dxf_draw_arc [exp]
  • dxf_write_ellipse [exp]
• dxf_draw_rect [exp]
  • dxf_write_polyline [exp]
  • dxf_write_vertex [stable]
  • dxf_write_endseq [stable]
• dxf_fill_circle [exp]
  • dxf_write_circle [exp]
• dxf_fill_polygon [exp]
  • dxf_write_hatch [stable]
  • dxf_write_hatch_boundary_path_polyline [stable]
  • dxf_write_hatch_boundary_path_polyline_vertex [stable]
• dxf_fill_rect [stable]
  • dxf_write_solid [stable]
• dxf_calibrate [stable]
• dxf_set_crosshair [stable]

Notes:
[todo] denotes a function not yet implemented.
[exp] denotes a function not yet fully implemented.
[stable] denotes a function fully implemented.

---

Include files

Definition in file dxf.c.

#include <stdio.h>
#include <stdarg.h>
#include <stdlib.h>
#include <string.h>
#include <time.h>
#include "global.h"
#include "data.h"
#include "error.h"
#include "misc.h"
#include "hid.h"
#include "../hidint.h"

Include dependency graph for dxf.c:

Go to the source code of this file.

Data Structures
struct	Aperture
	Aperture properties. More...
struct	Apertures
	List of apertures. More...
struct	DxfPendingDrills
	Drill (hole) properties. More...
struct	hid_gc_struct
	Definition of graphic context for the dxf HID. More...
struct	_StringList
	List with string data. More...
struct	_DxfList
	List with pcb element header data. More...
Defines
#define	CRASH   fprintf(stderr, "HID error: pcb called unimplemented DXF function %s.\n", __FUNCTION__); abort()
	Error handling of not yet implemented functions.
#define	DXF_X(pcb, x)   ((long) ((x) / 100))
	Dxf X-coordinate (in mil).
#define	DXF_Y(pcb, y)   ((long) (((pcb)->MaxHeight - (y))) / 100)
	Dxf Y-coordinate (in mil).
#define	DXF_XOffset(pcb, x)   ((long) ((x) / 100))
	Dxf X offset (in mil).
#define	DXF_YOffset(pcb, y)   ((long) (-(y) / 100))
	Dxf Y offset (in mil).
#define	DXF_ROUND(x)   ((int)(((x) + 50) / 100) * 100)
#define	DEBUG   1
	Debugging on/off switch.
#define	DXF_COLOR_BYBLOCK   0
	DXF color definition, entities with this color follow the color definition of the block in which it lives.
#define	DXF_COLOR_RED   1
	DXF color definition, pen number "1" in the virtual pen-plotter.
#define	DXF_COLOR_YELLOW   2
	DXF color definition, pen number "2" in the virtual pen-plotter.
#define	DXF_COLOR_GREEN   3
	DXF color definition, pen number "3" in the virtual pen-plotter.
#define	DXF_COLOR_CYAN   4
	DXF color definition, pen number "4" in the virtual pen-plotter.
#define	DXF_COLOR_BLUE   5
	DXF color definition, pen number "5" in the virtual pen-plotter.
#define	DXF_COLOR_MAGENTA   6
	DXF color definition, pen number "6" in the virtual pen-plotter.
#define	DXF_COLOR_WHITE   7
	DXF color definition, pen number "7" in the virtual pen-plotter.
#define	DXF_COLOR_GREY   8
	DXF color definition, pen number "8" in the virtual pen-plotter.
#define	DXF_COLOR_BYLAYER   256
	DXF color definition, color of the entity follows the color definition of the layer on which it lives.
#define	DXF_MODELSPACE   0
	This is where our hardware is going to live, default value, can be ommitted in dxf output.
#define	DXF_PAPERSPACE   1
	This is where your annotation (papersheet templates, fab notes and such) should live, has to be included in DXF output for any entity to live on paperspace.
#define	DXF_DEFAULT_LAYER   "0"
	There is always a layer "0" defined, it's reasonably safe to assume that this is a valid layername.
#define	DXF_DEFAULT_LINETYPE   "BYLAYER"
	There is always a linetype "BYLAYER" defined, it's reasonably safe to assume that this is a valid linetype.
#define	DXF_DEFAULT_TEXTSTYLE   "STANDARD"
	There is always a textstyle "STANDARD" defined, it's reasonably safe to assume that this is a valid text style.
#define	DXF_DEFAULT_XREF_PATH_NAME   "parts"
	Directory where 3D models of parts live.
#define	DXF_DIR_SEPARATOR   "\\"
	Directory separator character (back slash).
#define	DXF_DEFAULT_HATCH_PATTERN_NAME   "SOLID"
	Default hatch pattern for pcb polygons.
#define	HA_dxffile   0
#define	HA_metric   1
#define	HA_color_byblock   2
#define	HA_xrefs   3
#define	HA_xreffile   4
#define	HA_verbose   5
#define	NUM_OPTIONS   (sizeof(dxf_options)/sizeof(dxf_options[0]))
Typedefs
typedef enum ApertureShape	ApertureShape
	Shape of aperture.
typedef _StringList	StringList
	List with string data.
typedef _DxfList	DxfList
	List with pcb element header data.
Enumerations
enum	ApertureShape {   ROUND, OCTAGON, SQUARE, ROUNDCLEAR,   SQUARECLEAR, THERMAL }
	Shape definitions of apertures. More...
Functions
	RCSID ("$Id$")
	RCS identification string.
static int	dxf_find_aperture_code (int width, ApertureShape shape)
	Find aperture code.
static void	dxf_init_apertures ()
static void	dxf_set_app_layer (int l)
static int	dxf_group_for_layer (int l)
	Find a group for a given layer ??.
static int	dxf_layer_sort (const void *va, const void *vb)
	Sort layers ??.
static double	dxf_xy_to_angle (double x, double y)
	Convert pcb x,y coordinates to an angle relative to (0.0, 0.0).
static char *	dxf_clean_string (char *in)
	Clean up a string.
static StringList *	dxf_string_insert (char *str, StringList *list)
	Insert the string to the list of strings.
static void	dxf_write_block (FILE *fp, int id_code, char *xref_name, char *block_name, char *linetype, char *layer, double x0, double y0, double z0, double thickness, int color, int paperspace, int block_type)
	Write DXF output to a file for a block entity.
static void	dxf_write_table_block_record (FILE *fp)
	Write DXF output to a file for a BLOCK_RECORD table.
static void	dxf_write_circle (FILE *fp, int id_code, char *linetype, char *layer, double x0, double y0, double z0, double extr_x0, double extr_y0, double extr_z0, double thickness, double radius, int color, int paperspace)
	Write DXF output to a file for a CIRCLE entity.
static void	dxf_write_comment (FILE *fp, char *comment_string)
	Write DXF output for a comment string with line termination.
static void	dxf_write_ellipse (FILE *fp, int id_code, char *linetype, char *layer, double x0, double y0, double z0, double x1, double y1, double z1, double extr_x0, double extr_y0, double extr_z0, double thickness, double ratio, double start_angle, double end_angle, int color, int paperspace)
	Write DXF output to a file for an ellipse entity.
static void	dxf_write_endsection (FILE *fp)
	Write DXF output to a file for an end of section marker.
static void	dxf_write_endseq (FILE *fp)
	Write DXF output to a file for an end of sequence marker.
static void	dxf_write_eof (FILE *fp)
	Write dxf output to a file for an EOF marker.
static void	dxf_write_hatch (FILE *fp, char *pattern_name, int id_code, char *linetype, char *layer, double x0, double y0, double z0, double extr_x0, double extr_y0, double extr_z0, double thickness, double pattern_scale, double pixel_size, double pattern_angle, int color, int paperspace, int solid_fill, int associative, int style, int pattern_style, int pattern_double, int pattern_def_lines, int boundary_paths, int seed_points, double *seed_x0, double *seed_y0)
	Write DXF output to a file for a hatch entity.
static void	dxf_write_hatch_boundary_path_polyline (FILE *fp, int type_flag, int polyline_has_bulge, int polyline_is_closed, int polyline_vertices)
	Write DXF output to a file for a hatch boundary path polyline.
static void	dxf_write_hatch_boundary_path_polyline_vertex (FILE *fp, double x0, double y0, double bulge)
	Write DXF output to a file for a hatch boundary polyline entity.
static void	dxf_write_header_imperial_new (FILE *fp)
	Write DXF output to a file for a imperial DXF header.
static void	dxf_write_header_metric_new (FILE *fp)
	Write DXF output to a file for a metric DXF header.
static void	dxf_write_header (FILE *fp)
	Write DXF output to a file for a DXF header derived from a default header template file if available. If no default header template file is available, generate one depending on the dxf_metric variable.
static void	dxf_write_insert (FILE *fp, int id_code, char *block_name, char *linetype, char *layer, double x0, double y0, double z0, double thickness, double rel_x_scale, double rel_y_scale, double rel_z_scale, double column_spacing, double row_spacing, double rot_angle, int color, int attribute_follows, int paperspace, int columns, int rows)
	Write DXF output to a file for an insert entity.
static void	dxf_write_polyline (FILE *fp, int id_code, char *linetype, char *layer, double x0, double y0, double z0, double extr_x0, double extr_y0, double extr_z0, double thickness, double start_width, double end_width, int color, int vertices_follow, int paperspace, int flag, int polygon_mesh_M_vertex_count, int polygon_mesh_N_vertex_count, int smooth_M_surface_density, int smooth_N_surface_density, int surface_type)
	Write DXF output to a file for a polyline entity.
static void	dxf_write_section (FILE *fp, char *section_name)
	Write DXF output to a file for a section marker.
static void	dxf_write_solid (FILE *fp, int id_code, char *linetype, char *layer, double x0, double y0, double z0, double x1, double y1, double z1, double x2, double y2, double z2, double x3, double y3, double z3, double thickness, int color, int paperspace)
	Write DXF output to a file for a solid entity.
static void	dxf_write_vertex (FILE *fp, int id_code, char *linetype, char *layer, double x0, double y0, double z0, double thickness, double start_width, double end_width, double bulge, double curve_fit_tangent_direction, int color, int paperspace, int flag)
	Write DXF output to a file for a polyline vertex entity.
static HID_Attribute *	dxf_get_export_options (int *n)
	Get export options such as filename and filename base.
static DxfList *	dxf_insert (char *refdes, char *descr, char *value, DxfList *dxf)
	Insert an element in the list of elements.
static int	dxf_export_xref_file (void)
	Print Xrefs to DXF file.
static void	dxf_maybe_close_file ()
	Close DXF layer file.
static void	dxf_do_export (HID_Attr_Val *options)
	Export (or print) the current PCB.
static void	dxf_parse_arguments (int *argc, char ***argv)
	Parse the command line.
static int	dxf_drill_sort (const void *va, const void *vb)
	Sort drills (holes).
static int	dxf_set_layer (const char *name, int group)
	Set the layer with name for DXF export.
static hidGC	dxf_make_gc (void)
	Constructor for the graphic context.
static void	dxf_destroy_gc (hidGC gc)
	Destructor for the graphic context.
static void	dxf_use_mask (int use_it)
static void	dxf_set_color (hidGC gc, const char *name)
	Set a color.
static void	dxf_set_line_cap (hidGC gc, EndCapStyle style)
	Set the line style.
static void	dxf_set_line_width (hidGC gc, int width)
	Set the line width.
static void	dxf_use_gc (hidGC gc, int radius)
	Use the graphic context.
static void	dxf_draw_rect (hidGC gc, int x1, int y1, int x2, int y2)
	Draw a rectangle.
static void	dxf_draw_line (hidGC gc, int x1, int y1, int x2, int y2)
	Draw a line.
static void	dxf_draw_arc (hidGC gc, int cx, int cy, int width, int height, int start_angle, int delta_angle)
	Draw an (elliptic ?) arc.
static void	dxf_fill_circle (hidGC gc, int cx, int cy, int radius)
	Draw a filled circle.
static void	dxf_fill_polygon (hidGC gc, int n_coords, int *x, int *y)
	Draw a filled polygon.
static void	dxf_fill_rect (hidGC gc, int x1, int y1, int x2, int y2)
	Draw a filled rectangle.
static void	dxf_calibrate (double xval, double yval)
	This is for the printer.
static void	dxf_set_crosshair (int x, int y)
	Sets the crosshair.
static void	dxf_show_item (void *item)
	Show item ?.
static void	dxf_beep (void)
	Send beep signal to stdout ?.
static void	dxf_progress (int dxf_so_far, int dxf_total, const char *dxf_message)
	Show porgress ?.
void	hid_dxf_init ()
	Call this as soon as possible from main().
Variables
static HID	dxf_hid
static int	is_mask
	Layer is a mask.
static int	current_mask
	Current mask.
static int	is_drill
	Entity is a drill (hole).
static int	was_drill
static Apertures *	layerapps = 0
static Apertures *	curapp
static int	n_layerapps = 0
static int	c_layerapps = 0
DxfPendingDrills *	dxf_pending_drills = 0
	Pending drill (holes).
int	dxf_n_pending_drills = 0
	Number of pending drill (holes).
int	dxf_max_pending_drills = 0
	Maximum number of pending drills (holes).
static HID_Attribute	dxf_options []
	Definition of options the user can select in the DXF exporter dialog.
static HID_Attr_Val	dxf_values [NUM_OPTIONS]
	Used for HID attributes (exporting and printing, mostly).
static FILE *	f = 0
	File pointer for DXF layer files.
static char *	dxf_filename
	File name of layer DXF files.
static char *	dxf_header_filename
	File name of DXF header template file.
static char *	dxf_filesuffix
	File name suffix for layer files.
static char *	dxf_layername = 0
	Layer name.
static int	lncount = 0
	Line count ??.
static int	dxf_xrefs
	DXF file with xrefs needed.
static char *	dxf_xref_filename
	File name of Xref (blocks) DXF file.
static int	dxf_metric
	DXF file with output in mm (not mils).
static int	dxf_color_is_byblock
	DXF file with layer color BYBLOCK (or by layer number).
static int	dxf_verbose
	DXF file with verbose output (to contain DXF comments).
static int	dxf_id_code = 0
	Every DXF entity has a unique identifier (per DXF file).
static int	finding_apertures = 0
static int	pagecount = 0
static int	linewidth = -1
static int	lastgroup = -1
static int	lastcap = -1
static int	lastcolor = -1
static int	print_group [MAX_LAYER]
static int	print_layer [MAX_LAYER]
static int	dxf_lastX
	The last X coordinate.
static int	dxf_lastY
	The last Y coordinate.
static HID	dxf_hid
	Record with all values of the DXF HID.

---

Define Documentation

#define CRASH   fprintf(stderr, "HID error: pcb called unimplemented DXF function %s.\n", __FUNCTION__); abort()

Error handling of not yet implemented functions. Definition at line 280 of file dxf.c.

#define DEBUG   1

Debugging on/off switch. Definition at line 307 of file dxf.c.

#define DXF_COLOR_BLUE   5

DXF color definition, pen number "5" in the virtual pen-plotter. Definition at line 338 of file dxf.c.

#define DXF_COLOR_BYBLOCK   0

DXF color definition, entities with this color follow the color definition of the block in which it lives. Definition at line 313 of file dxf.c. Referenced by dxf_draw_arc(), dxf_draw_line(), dxf_draw_rect(), dxf_fill_circle(), dxf_fill_polygon(), and dxf_fill_rect().

#define DXF_COLOR_BYLAYER   256

DXF color definition, color of the entity follows the color definition of the layer on which it lives. Definition at line 359 of file dxf.c. Referenced by dxf_export_xref_file(), dxf_fill_polygon(), dxf_write_circle(), dxf_write_ellipse(), dxf_write_hatch(), dxf_write_insert(), dxf_write_polyline(), dxf_write_solid(), and dxf_write_vertex().

#define DXF_COLOR_CYAN   4

DXF color definition, pen number "4" in the virtual pen-plotter. Definition at line 333 of file dxf.c.

#define DXF_COLOR_GREEN   3

DXF color definition, pen number "3" in the virtual pen-plotter. Definition at line 328 of file dxf.c.

#define DXF_COLOR_GREY   8

DXF color definition, pen number "8" in the virtual pen-plotter. Definition at line 353 of file dxf.c.

#define DXF_COLOR_MAGENTA   6

DXF color definition, pen number "6" in the virtual pen-plotter. Definition at line 343 of file dxf.c.

#define DXF_COLOR_RED   1

DXF color definition, pen number "1" in the virtual pen-plotter. Definition at line 318 of file dxf.c.

#define DXF_COLOR_WHITE   7

DXF color definition, pen number "7" in the virtual pen-plotter. Definition at line 348 of file dxf.c.

#define DXF_COLOR_YELLOW   2

DXF color definition, pen number "2" in the virtual pen-plotter. Definition at line 323 of file dxf.c.

#define DXF_DEFAULT_HATCH_PATTERN_NAME   "SOLID"

Default hatch pattern for pcb polygons. Todo: For now the hatch pattern name is set to "SOLID". If pcb is ever to have thieving implemented, a hatch pattern name field has to be added to the graphic context. Definition at line 418 of file dxf.c. Referenced by dxf_fill_polygon().

#define DXF_DEFAULT_LAYER   "0"

There is always a layer "0" defined, it's reasonably safe to assume that this is a valid layername. Definition at line 378 of file dxf.c. Referenced by dxf_draw_arc(), dxf_draw_line(), dxf_draw_rect(), dxf_export_xref_file(), dxf_fill_circle(), dxf_fill_polygon(), dxf_fill_rect(), dxf_write_block(), dxf_write_circle(), dxf_write_ellipse(), dxf_write_hatch(), dxf_write_insert(), dxf_write_polyline(), dxf_write_solid(), and dxf_write_vertex().

#define DXF_DEFAULT_LINETYPE   "BYLAYER"

There is always a linetype "BYLAYER" defined, it's reasonably safe to assume that this is a valid linetype. Definition at line 384 of file dxf.c. Referenced by dxf_draw_arc(), dxf_draw_line(), dxf_draw_rect(), dxf_export_xref_file(), dxf_fill_circle(), dxf_fill_polygon(), dxf_fill_rect(), dxf_write_circle(), dxf_write_ellipse(), dxf_write_hatch(), dxf_write_insert(), dxf_write_polyline(), dxf_write_solid(), and dxf_write_vertex().

#define DXF_DEFAULT_TEXTSTYLE   "STANDARD"

There is always a textstyle "STANDARD" defined, it's reasonably safe to assume that this is a valid text style. Definition at line 390 of file dxf.c.

#define DXF_DEFAULT_XREF_PATH_NAME   "parts"

Directory where 3D models of parts live. For now the dxf_xref_pathname is set to "parts", in AutoCAD one can configure default search directories for xrefs. Definition at line 398 of file dxf.c. Referenced by dxf_export_xref_file().

#define DXF_DIR_SEPARATOR   "\\"

Directory separator character (back slash). For now we live in a micro$oft & Autodesk universe with all of their quirks. Todo: This has to be solved in a more elegant manner if we want to use DXF file on *nix based CAD software. Definition at line 409 of file dxf.c. Referenced by dxf_write_block().

#define DXF_MODELSPACE   0

This is where our hardware is going to live, default value, can be ommitted in dxf output. Definition at line 365 of file dxf.c.

#define DXF_PAPERSPACE   1

This is where your annotation (papersheet templates, fab notes and such) should live, has to be included in DXF output for any entity to live on paperspace. Definition at line 372 of file dxf.c. Referenced by dxf_write_block(), dxf_write_circle(), dxf_write_ellipse(), dxf_write_hatch(), dxf_write_insert(), dxf_write_polyline(), dxf_write_solid(), and dxf_write_vertex().

#define DXF_X (  pcb, x   )     ((long) ((x) / 100))

Dxf X-coordinate (in mil). Definition at line 285 of file dxf.c. Referenced by dxf_draw_arc(), dxf_draw_line(), dxf_draw_rect(), dxf_fill_circle(), dxf_fill_polygon(), dxf_fill_rect(), and dxf_set_layer().

#define DXF_XOffset (  pcb, x   )     ((long) ((x) / 100))

Dxf X offset (in mil). Definition at line 295 of file dxf.c.

#define DXF_Y (  pcb, y   )     ((long) (((pcb)->MaxHeight - (y))) / 100)

Dxf Y-coordinate (in mil). Definition at line 290 of file dxf.c. Referenced by dxf_draw_arc(), dxf_draw_line(), dxf_draw_rect(), dxf_fill_circle(), dxf_fill_polygon(), dxf_fill_rect(), and dxf_set_layer().

#define DXF_YOffset (  pcb, y   )     ((long) (-(y) / 100))

Dxf Y offset (in mil). Definition at line 300 of file dxf.c.

---

Typedef Documentation

typedef enum ApertureShape ApertureShape

Shape of aperture. Definition at line 441 of file dxf.c.

typedef struct _DxfList DxfList

List with pcb element header data.

typedef struct _StringList StringList

List with string data.

---

Enumeration Type Documentation

enum ApertureShape

Shape definitions of apertures. Enumerator: ROUND  shaped like a circle OCTAGON  octagonal shape SQUARE  shaped like a square ROUNDCLEAR  clearance in negatives SQUARECLEAR  clearance in negatives THERMAL  negative thermal relief Definition at line 428 of file dxf.c.

---

Function Documentation

static void dxf_beep (  void   )  [static]

Send beep signal to stdout ?. Definition at line 5101 of file dxf.c.

static void dxf_calibrate (  double  xval, double  yval )  [static]

This is for the printer. If you call this for the GUI, xval and yval are ignored, and a dialog pops up to lead you through the calibration procedure. For the printer, if xval and yval are zero, a calibration page is printed with instructions for calibrating your printer. After calibrating, nonzero xval and yval are passed according to the instructions. Metric is nonzero if the user prefers metric units, else inches are used. Calibrate a DXF file ?. Since we do not calibrate a DXF file, we ignore this one. Parameters: xval  X-value yval  Y-value Definition at line 5060 of file dxf.c.

static char* dxf_clean_string (  char *  in  )  [static]

Clean up a string. Copy over input string to output string with some character conversions. Go all the way to end of string to get the termination character. Definition at line 921 of file dxf.c. Referenced by dxf_export_xref_file().

static void dxf_destroy_gc (  hidGC  gc  )  [static]

Destructor for the graphic context. Definition at line 3533 of file dxf.c.

static void dxf_do_export (  HID_Attr_Val *  options  )  [static]

Export (or print) the current PCB. The options given represent the choices made from the options returned from dxf_get_export_options. Call with options == NULL to start the primary GUI (create a main window, print, export, etc). First get the export options. Do export all the DXF files required. Export the DXF file with Xref blocks to a seperate dxf file if required. Export a DXF file for every PCB layer. Definition at line 3078 of file dxf.c. References dxf_get_export_options(), and NUM_OPTIONS. Here is the call graph for this function:

static void dxf_draw_arc (  hidGC  gc, int  cx, int  cy, int  width, int  height, int  start_angle, int  delta_angle )  [static]

Draw an (elliptic ?) arc. The usual drawing functions. "draw" means to use segments of the given width, whereas "fill" means to fill to a zero-width outline. For now we draw an (elliptic) arc with the assumption that the width is along the X-axis and the height is along the Y-axis. Thus the major axis of the ellipse has a size of 2 * the maximum of the greatest value of [width, height], and the minor axis has a size of 2 * the minimum value of [width, height]. An elliptic arc with a line width of 0 is implemented for now. Todo: The elliptic arc entity has to be replaced by a polyline with the correct line width (trace width). In the case of a series of trace segments, continue with a vertex from the last XY-coordinates. While the conditions for starting or continuing are simple to determine: if ((x1, y1) == dxf_lastX, dxf_lastY)) ... The caveat is how to determine when to close the polyline sequence (with an ENDSEQ marker) after the last vertex (endpoint of the last trace segment). The end cap style has to be implemented at the start and end point of a trace. Parameters: gc  graphic context cx  X-value center point cy  X-value center point width  length of major axis height  length of minor axis start_angle  start angle of elliptic arc delta_angle  relative angle to end angle Definition at line 4409 of file dxf.c. References DXF_COLOR_BYBLOCK, DXF_DEFAULT_LAYER, DXF_DEFAULT_LINETYPE, dxf_use_gc(), dxf_write_ellipse(), dxf_write_endseq(), dxf_write_polyline(), dxf_write_vertex(), DXF_X, DXF_Y, and ROUND. Here is the call graph for this function:

static void dxf_draw_line (  hidGC  gc, int  x1, int  y1, int  x2, int  y2 )  [static]

Draw a line. The usual drawing functions. "draw" means to use segments of the given width, whereas "fill" means to fill to a zero-width outline. Translate the pcb X,Y-coordinates of lines and trace segments to dxf X,Y,Z-coordinates. Add layer, linetype, color and width values. Write a series of polylines and vertices by calling low level functions. If the endcap style is ROUND add a donut at the begin and end coordinates of the line segment. If the endcap style is SQUARE elongate the line segment with half its width. Remarks: We do not draw lines of 1 mil wide or smaller. We do not draw lines with identical start and end XY-coordinates (zero length). We draw every trace segment as a single AutoCAD entity (polyline). Todo: In case of a series of trace segments, we have to continue with a vertex from the last XY-coordinates. While the conditions for starting or continuing are simple to determine: if ((dxf_x1, dxf_y1) == dxf_lastX, dxf_lastY)) ... The caveat is how to determine when to close the polyline sequence (with an ENDSEQ marker) after the last vertex (endpoint of the last trace segment). One approach could be to close the series when the start coordinates of the new (to be drawn) trace segment do not coincide with the endpoint of the previously used trace segment (dxf_last[X. Y] values). This however would not be a solution for a branching trace segment or the last trace segment to be drawn on that particular layer. For the last trace segment to be drawn on a particular layer, we would have to check if the layer didn't change since the last trace segment was drawn. Todo: Someday we have to do something here with multiple trace segments here, the problem for now is how to determine when the last trace segment was passed. Todo: This end cap style has yet to be implemented at the start and end point of a trace. Note: done for ROUND and SQUARE. Parameters: gc  graphic context x1  X-value start point y1  Y-value start point x2  X-value end point y2  Y-value end point Definition at line 4005 of file dxf.c. References DXF_COLOR_BYBLOCK, DXF_DEFAULT_LAYER, DXF_DEFAULT_LINETYPE, dxf_use_gc(), dxf_write_endseq(), dxf_write_polyline(), dxf_write_vertex(), DXF_X, DXF_Y, OCTAGON, ROUND, and SQUARE. Here is the call graph for this function:

static void dxf_draw_rect (  hidGC  gc, int  x1, int  y1, int  x2, int  y2 )  [static]

Draw a rectangle. The usual drawing functions. "draw" means to use segments of the given width, whereas "fill" means to fill to a zero-width outline. We draw the rectangle counter clockwise (CCW) with 5 vertices (XY-coordinates). It is assumed that the first XY-coordinate pair (x1, y1) contains the bottom left corner values and that the second XY-coordinate pair (x2, y2) contains the top right corner values. The rectangle is not filled, use dxf_fill_rect () for a filled rectangle. Parameters: gc  graphic context x1  X-value bottom left ?? point y1  Y-value bottom left ?? point x2  X-value top right ?? point y2  Y-value top right ?? point Definition at line 3767 of file dxf.c. References DXF_COLOR_BYBLOCK, DXF_DEFAULT_LAYER, DXF_DEFAULT_LINETYPE, dxf_write_endseq(), dxf_write_polyline(), dxf_write_vertex(), DXF_X, and DXF_Y. Here is the call graph for this function:

static int dxf_drill_sort (  const void *  va, const void *  vb )  [static]

Sort drills (holes). Definition at line 3220 of file dxf.c. References DxfPendingDrills::diam, DxfPendingDrills::x, and DxfPendingDrills::y. Referenced by dxf_set_layer().

static int dxf_export_xref_file (  void   )  [static]

Print Xrefs to DXF file. Generate a file in the AutoCAD R14 DXF format for insertion of 3D models as external references (Xref's). An external reference is a reference to an external drawing block which is loaded at runtime (of the mechanical CAD software; for example AutoCAD) during the loading of the toplevel drawing model (the dxf file) in a mechanical CAD program or during separate insertions after the initial loading whilst in drawing mode. Note that for most mechanical CAD software the inserted block cannot be a DXF file. In most cases a DXF file representing a (3D) model must first be converted to a ".dwg" file, or any other file format native to the mechanical CAD software used. The filename of the 3D model inserted in the dxf file is: "Description or footprint name" + ".dwg" (file extension). Any element without a valid description or footprint name is inserted in the dxf file with a 3D model with a text "undefined part" and this has to be manually inserted in the toplevel model after the initial loading of the dxf file. This is to prevent unnoticed ommissions of parts in the toplevel 3D model. Definition at line 2720 of file dxf.c. References _DxfList::descr, dxf_clean_string(), DXF_COLOR_BYLAYER, DXF_DEFAULT_LAYER, DXF_DEFAULT_LINETYPE, DXF_DEFAULT_XREF_PATH_NAME, dxf_insert(), dxf_write_block(), dxf_write_comment(), dxf_write_endsection(), dxf_write_eof(), dxf_write_header(), dxf_write_insert(), dxf_write_section(), dxf_xy_to_angle(), and _DxfList::next. Here is the call graph for this function:

static void dxf_fill_circle (  hidGC  gc, int  cx, int  cy, int  radius )  [static]

Draw a filled circle. The usual drawing functions. "draw" means to use segments of the given width, whereas "fill" means to fill to a zero-width outline. Todo: Implement a donut (polyline) instead of a circle. Parameters: gc  graphic context cx  X-value center point cy  Y-value center point radius  radius of circle Definition at line 4760 of file dxf.c. References DxfPendingDrills::diam, DXF_COLOR_BYBLOCK, DXF_DEFAULT_LAYER, DXF_DEFAULT_LINETYPE, dxf_max_pending_drills, dxf_n_pending_drills, dxf_pending_drills, DXF_ROUND, dxf_use_gc(), dxf_write_circle(), DXF_X, DXF_Y, is_drill, DxfPendingDrills::x, and DxfPendingDrills::y. Here is the call graph for this function:

static void dxf_fill_polygon (  hidGC  gc, int  n_coords, int *  x, int *  y )  [static]

Draw a filled polygon. The usual drawing functions. "draw" means to use segments of the given width, whereas "fill" means to fill to a zero-width outline. A polygon is drawn with a solid fill pattern. The filled polygon is by drawn by a (closed) polyline sequence with (n_coords + 1) vertices and add a SOLID hatch pattern to this polyline. This solution would allow for thieving if it were ever implemented in pcb (select a hatch pattern, create a boundary path, apply a scale and all the other stuff that is needed). Parameters: gc  graphic context n_coords  number of XY-coordinates x  pointer to array of X-values of coordinates y  pointer to array of Y-values of coordinates Definition at line 4861 of file dxf.c. References current_mask, DXF_COLOR_BYBLOCK, DXF_COLOR_BYLAYER, DXF_DEFAULT_HATCH_PATTERN_NAME, DXF_DEFAULT_LAYER, DXF_DEFAULT_LINETYPE, dxf_use_gc(), dxf_write_hatch(), dxf_write_hatch_boundary_path_polyline(), dxf_write_hatch_boundary_path_polyline_vertex(), DXF_X, DXF_Y, and is_mask. Here is the call graph for this function:

static void dxf_fill_rect (  hidGC  gc, int  x1, int  y1, int  x2, int  y2 )  [static]

Draw a filled rectangle. The usual drawing functions. "draw" means to use segments of the given width, whereas "fill" means to fill to a zero-width outline. Parameters: gc  graphic context x1  X-value bottom left ?? point y1  Y-value bottom left ?? point x2  X-value top right ?? point y2  Y-value top right ?? point Definition at line 4977 of file dxf.c. References DXF_COLOR_BYBLOCK, DXF_DEFAULT_LAYER, DXF_DEFAULT_LINETYPE, dxf_write_solid(), DXF_X, and DXF_Y. Here is the call graph for this function:

static int dxf_find_aperture_code (  int  width, ApertureShape  shape )  [static]

Find aperture code. Search for an appropriate aperture, and if not found, create a new aperture and add it to the list. When line width is 0 nothing is done. Parameters: width  Line width shape  aperture for drawing line (cap style) Definition at line 525 of file dxf.c. References Apertures::aperture, Aperture::apertureShape, Aperture::apertureSize, curapp, Aperture::dCode, and Apertures::nextAperture. Referenced by dxf_set_layer(), and dxf_use_gc().

static HID_Attribute* dxf_get_export_options (  int *  n  )  [static]

Get export options such as filename and filename base. Returns a set of resources describing options the export or print HID supports. In GUI mode, the print/export dialogs use this to set up the selectable options. In command line mode, these are used to interpret command line options. If n_ret is non-NULL, the number of attributes is stored there. Definition at line 2606 of file dxf.c. References NUM_OPTIONS. Referenced by dxf_do_export().

static int dxf_group_for_layer (  int  l  )  [static]

Find a group for a given layer ??. Definition at line 849 of file dxf.c. Referenced by dxf_layer_sort().

static DxfList* dxf_insert (  char *  refdes, char *  descr, char *  value, DxfList *  dxf )  [static]

Insert an element in the list of elements. Parameters: refdes  reference designator. descr  description or footprint. value  element value. dxf  next item in list. Definition at line 2633 of file dxf.c. References _DxfList::descr, dxf_string_insert(), _DxfList::next, _DxfList::num, _DxfList::refdes, and _DxfList::value. Referenced by dxf_export_xref_file(). Here is the call graph for this function:

static int dxf_layer_sort (  const void *  va, const void *  vb )  [static]

Sort layers ??. Definition at line 868 of file dxf.c. References dxf_group_for_layer(). Here is the call graph for this function:

static hidGC dxf_make_gc (  void   )  [static]

Constructor for the graphic context. Definition at line 3516 of file dxf.c.

static void dxf_maybe_close_file (   )  [static]

Close DXF layer file. Definition at line 3042 of file dxf.c. References dxf_write_eof(). Here is the call graph for this function:

static void dxf_parse_arguments (  int *  argc, char ***  argv )  [static]

Parse the command line. Parse HID register attributes and HID command line arguments. Call this early for whatever HID will be the primary HID, as it will set all the registered attributes. The HID should remove all arguments, leaving any possible file names behind. Definition at line 3203 of file dxf.c.

static void dxf_progress (  int  dxf_so_far, int  dxf_total, const char *  dxf_message )  [static]

Show porgress ?. Definition at line 5111 of file dxf.c.

static void dxf_set_color (  hidGC  gc, const char *  name )  [static]

Set a color. Set the color of the entity. Names can be like "red" or "#rrggbb" or special names like "erase". Always use the "erase" color for removing ink (like polygon reliefs or thermals), as you cannot rely on knowing the background color or special needs of the HID. Always use the "drill" color to draw holes. You may assume this is cheap enough to call inside the redraw callback, but not cheap enough to call for each item drawn. Parameters: gc  graphic context Definition at line 3591 of file dxf.c.

static void dxf_set_crosshair (  int  x, int  y )  [static]

Sets the crosshair. Which may differ from the pointer depending on grid and pad snap. Note that the HID is responsible for hiding, showing, redrawing, etc. The core just tells it what coordinates it's actually using. Note that this routine may need to know what "pcb units" are so it can display them in mm or mils accordingly. Set a crosshair in a DXF file ?. Since it is useless to set a crosshair in a DXF file, we ignore this one. Parameters: x  X-value of coordinate y  Y-value of coordinate Definition at line 5081 of file dxf.c.

static int dxf_set_layer (  const char *  name, int  group )  [static]

Set the layer with name for DXF export. During redraw or print/export cycles, this is called once per layer (or layer group, for copper layers). If it returns false (zero), the HID does not want that layer, and none of the drawing functions should be called. If it returns true (nonzero), the items in that layer [group] should be drawn using the various drawing functions. In addition to the MAX_LAYERS copper layer groups, you may select layers indicated by the macros SL_* defined, or any others with an index of -1. For copper layer groups, you may pass NULL for name to have a name fetched from the PCB struct. All copper containing layers are set for DXF export. All assembly layers are set for DXF export. Exceptions are: Layers with the name "invisible" are not set for DXF export. Layers with the name "keepout" are not set for DXF export. Layers without exportable items are not set for DXF export. Todo: this output should go to file in whatever form instead of being put on stderr. Todo: this output should go to file in whatever form instead of being put on stderr. Todo: this output should go to file in whatever form instead of being put on stderr. Todo: FIXME: probably a decent return code needs to be added here. Definition at line 3263 of file dxf.c. References dxf_drill_sort(), dxf_find_aperture_code(), dxf_n_pending_drills, dxf_pending_drills, DXF_X, DXF_Y, is_drill, and ROUND. Here is the call graph for this function:

static void dxf_set_line_cap (  hidGC  gc, EndCapStyle  style )  [static]

Set the line style. Set the line cap style in the graphic context. While calling this is cheap, calling it with different values each time may be expensive, so grouping items by line style is helpful. Definition at line 3631 of file dxf.c.

static void dxf_set_line_width (  hidGC  gc, int  width )  [static]

Set the line width. Set the line width in the graphic context. While calling this is cheap, calling it with different values each time may be expensive, so grouping items by line width is helpful. Definition at line 3655 of file dxf.c.

static void dxf_show_item (  void *  item  )  [static]

Show item ?. Definition at line 5093 of file dxf.c.

static StringList* dxf_string_insert (  char *  str, StringList *  list )  [static]

Insert the string to the list of strings. Definition at line 957 of file dxf.c. References _StringList::next. Referenced by dxf_insert().

static void dxf_use_gc (  hidGC  gc, int  radius )  [static]

Use the graphic context. Definition at line 3674 of file dxf.c. References dxf_find_aperture_code(), is_drill, is_mask, ROUND, and SQUARE. Referenced by dxf_draw_arc(), dxf_draw_line(), dxf_fill_circle(), and dxf_fill_polygon(). Here is the call graph for this function:

static void dxf_use_mask (  int  use_it  )  [static]

Special note about the "erase" color: To use this color, you must use this function to tell the HID when you're using it. At the beginning of a layer redraw cycle (i.e. after set_layer), call use_mask() to redirect output to a buffer. Draw to the buffer (using regular HID calls) using regular and "erase" colors. Then call use_mask(HID_MASK_OFF) to flush the buffer to the HID. If you use the "erase" color when use_mask is disabled, it simply draws in the background color. Values: HID_MASK_OFF == 0 Flush the buffer and return to non-mask operation. HID_MASK_BEFORE == 1 Polygons being drawn before clears. HID_MASK_CLEAR == 2 Clearances being drawn. HID_MASK_AFTER == 3 Polygons being drawn after clears. Definition at line 3564 of file dxf.c. References current_mask.

static void dxf_write_block (  FILE *  fp, int  id_code, char *  xref_name, char *  block_name, char *  linetype, char *  layer, double  x0, double  y0, double  z0, double  thickness, int  color, int  paperspace, int  block_type )  [static]

Write DXF output to a file for a block entity. The BLOCKS section of the DXF file contains all the block definitions. It contains the entities that make up the blocks used in the drawing, including anonymous blocks generated by the HATCH command and by associative dimensioning. The format of the entities in this section is identical to those in the ENTITIES section. All entities in the BLOCKS section appear between block and endblk entities. Block and endblk entities appear only in the BLOCKS section. Block definitions are never nested (that is, no block or endblk entity ever appears within another block-endblk pair), although a block definition can contain an insert entity. External references are written in the DXF file as block definitions, except that they also include a string (group code 1) that specifies the path and file name of the external reference. The block table handle, along with any xdata and persistent reactors, appears in each block definition immediately following the BLOCK record, which contains all of the specific information that a block table record stores. The UCS in effect when a block definition is created becomes the WCS for all entities in the block definition. The new origin for these entities is shifted to match the base point defined for the block definition. All entity data is translated to fit this new WCS. *MODEL_SPACE and *PAPER_SPACE Block Definition. Now, there are always two extra, empty definitions in the BLOCKS section, titled *MODEL_SPACE and *PAPER_SPACE. These definitions manifest the new representation of model space and paper space as block definitions internally. The entities contained in these definitions still appear in the ENTITIES section for compatibility. Model Space and Paper Space Entity Segregation. The interleaving between model space and paper space will no longer occurs, because of internal organization. Instead, all paper space entities are output, followed by model space entities. The flag distinguishing them is the group code 67. Todo: Add group code 102 stuff. Parameters: fp  file pointer to output device id_code  group code = 5 xref_name  group code = 1 block_name  group code = 2 and 3 linetype  group code = 6 optional, if omitted defaults to BYLAYER layer  group code = 8 x0  group code = 10 base point y0  group code = 20 base point z0  group code = 30 base point thickness  group code = 39 optional, if omitted defaults to 0.0 color  group code = 62 optional, if omitted defaults to BYLAYER paperspace  group code = 67 optional, if omitted defaults to 0 (modelspace) block_type  group code = 70 bit codes: 1 = this is an anonymous Block generated by hatching, associative dimensioning, other internal operations, or an application 2 = this Block has Attributes 4 = this Block is an external reference (Xref) 8 = not used 16 = this Block is externally dependent 32 = this is a resolved external reference, or dependent of an external reference 64 = this definition is referenced Definition at line 1038 of file dxf.c. References DXF_DEFAULT_LAYER, DXF_DIR_SEPARATOR, and DXF_PAPERSPACE. Referenced by dxf_export_xref_file().

static void dxf_write_circle (  FILE *  fp, int  id_code, char *  linetype, char *  layer, double  x0, double  y0, double  z0, double  extr_x0, double  extr_y0, double  extr_z0, double  thickness, double  radius, int  color, int  paperspace )  [static]

Write DXF output to a file for a CIRCLE entity. Todo: The CIRCLE entity has to be replaced by a POLYLINE entity with the correct line width (trace width). The CIRCLE entity is to be used for (unplated) drill holes only. In the mechanical CAD program these circles (drill holes) can be extruded to the board thickness and subtracted from the extruded pcb outline. Parameters: fp  file pointer to output device id_code  group code = 5 linetype  group code = 6 optional, defaults to BYLAYER layer  group code = 8 x0  group code = 10 base point y0  group code = 20 base point z0  group code = 30 base point extr_x0  group code = 210 extrusion direction optional, if ommited defaults to 0.0 extr_y0  group code = 220 extrusion direction optional, if ommited defaults to 0.0 extr_z0  group code = 230 extrusion direction optional, if ommited defaults to 1.0 thickness  group code = 39 optional, defaults to 0.0 radius  group code = 40 color  group code = 62 optional, defaults to BYLAYER paperspace  group code = 67 optional, defaults to 0 (modelspace) Definition at line 1155 of file dxf.c. References DXF_COLOR_BYLAYER, DXF_DEFAULT_LAYER, DXF_DEFAULT_LINETYPE, and DXF_PAPERSPACE. Referenced by dxf_fill_circle().

static void dxf_write_comment (  FILE *  fp, char *  comment_string )  [static]

Write DXF output for a comment string with line termination. The group code "999" indicates that the following line is a comment string. The AutoCAD command "DXFOUT" does not currently include such groups in a DXF output file. The AutoCAD command "DXFIN" honors them and ignores the comments. Thus, you can use the 999 group to include comments in a DXF file you've created. Parameters: fp  file pointer to output device comment_string  comment string Definition at line 1226 of file dxf.c. Referenced by dxf_export_xref_file().

static void dxf_write_ellipse (  FILE *  fp, int  id_code, char *  linetype, char *  layer, double  x0, double  y0, double  z0, double  x1, double  y1, double  z1, double  extr_x0, double  extr_y0, double  extr_z0, double  thickness, double  ratio, double  start_angle, double  end_angle, int  color, int  paperspace )  [static]

Write DXF output to a file for an ellipse entity. This entity requires AutoCAD version R14 or higher. The ellipse entity is currently used to draw arcs. Since the pcb file format allows for a height and a width value, it is thus possible to draw an elliptical arc. Todo: The ellipse entity has to be replaced by a polyline with the correct line width (trace width). When we figured out how to draw a polyline (with vertices) for an arc (part of a circle) or an elliptical arc (part of an ellipse). This function will then become obsolete. Parameters: fp  file pointer to output device id_code  group code = 5 linetype  group code = 6 optional, defaults to BYLAYER layer  group code = 8 x0  group code = 10 base point y0  group code = 20 base point z0  group code = 30 base point x1  group code = 11 endpoint of major axis, relative to the center (in WCS) y1  group code = 21 endpoint of major axis, relative to the center (in WCS) z1  group code = 31 endpoint of major axis, relative to the center (in WCS) extr_x0  group code = 210 extrusion direction optional, if ommited defaults to 0.0 extr_y0  group code = 220 extrusion direction optional, if ommited defaults to 0.0 extr_z0  group code = 230 extrusion direction optional, if ommited defaults to 1.0 thickness  group code = 39 optional, defaults to 0.0 ratio  group code = 40 ratio of minor axis to major axis start_angle  group code = 41 start parameter (this value is 0.0 for a full ellipse) end_angle  group code = 42 end parameter (this value is 2*pi for a full ellipse) color  group code = 62 optional, defaults to BYLAYER paperspace  group code = 67 optional, defaults to 0 (modelspace) Definition at line 1262 of file dxf.c. References DXF_COLOR_BYLAYER, DXF_DEFAULT_LAYER, DXF_DEFAULT_LINETYPE, and DXF_PAPERSPACE. Referenced by dxf_draw_arc().

static void dxf_write_endsection (  FILE *  fp  )  [static]

Write DXF output to a file for an end of section marker. Parameters: fp  file pointer to output device Definition at line 1340 of file dxf.c. Referenced by dxf_export_xref_file(), and dxf_write_header().

static void dxf_write_endseq (  FILE *  fp  )  [static]

Write DXF output to a file for an end of sequence marker. No fields. This marks the end of: vertices (one or more "Vertex" entity) of a Polyline attribute entities ("Attrib" entity) to an "Insert" entity that has Attributes (indicated by 66 group present and nonzero in Insert entity). Parameters: fp  file pointer to output device Definition at line 1367 of file dxf.c. Referenced by dxf_draw_arc(), dxf_draw_line(), and dxf_draw_rect().

static void dxf_write_eof (  FILE *  fp  )  [static]

Write dxf output to a file for an EOF marker. Parameters: fp  file pointer to output device Definition at line 1386 of file dxf.c. Referenced by dxf_export_xref_file(), and dxf_maybe_close_file().

static void dxf_write_hatch (  FILE *  fp, char *  pattern_name, int  id_code, char *  linetype, char *  layer, double  x0, double  y0, double  z0, double  extr_x0, double  extr_y0, double  extr_z0, double  thickness, double  pattern_scale, double  pixel_size, double  pattern_angle, int  color, int  paperspace, int  solid_fill, int  associative, int  style, int  pattern_style, int  pattern_double, int  pattern_def_lines, int  boundary_paths, int  seed_points, double *  seed_x0, double *  seed_y0 )  [static]

Write DXF output to a file for a hatch entity. This entity requires AutoCAD version R14 or higher. Todo: writing a hatch with a number of hatch_seed_points > 0 is creating a segmentation fault in the dxf hid (and thus pcb). Parameters: fp  file pointer to output device pattern_name  group code = 2 id_code  group code = 5 linetype  group code = 6 optional, defaults to BYLAYER layer  group code = 8 x0  group code = 10 base point y0  group code = 20 base point z0  group code = 30 base point extr_x0  group code = 210 extrusion direction optional, if ommited defaults to 0.0 extr_y0  group code = 220 extrusion direction optional, if ommited defaults to 0.0 extr_z0  group code = 230 extrusion direction optional, if ommited defaults to 1.0 thickness  group code = 39 optional, defaults to 0.0 pattern_scale  group code 41 pattern fill only pixel_size  group code 47 pattern_angle  group code 52 pattern fill only color  group code = 62 optional, defaults to BYLAYER paperspace  group code = 67 optional, defaults to 0 (modelspace) solid_fill  group code = 70 0 = pattern fill 1 = solid fill associative  group code = 71 0 = non-associative 1 = associative style  group code = 75 0 = hatch "odd parity" area (Normal style) 1 = hatch outermost area only (Outer style) 2 = hatch through entire area (Ignore style) pattern_style  group code = 75 0 = user defined 1 = predefined 2 = custom pattern_double  group code = 77 pattern fill only 0 = not double 1 = double pattern_def_lines  group code = 78 number of pattern definition lines boundary_paths  group code = 91 number of boundary paths (loops) seed_points  group code = 98 number of seed points seed_x0  group code = 10 seed point X-value seed_y0  group code = 20 seed point Y-value Definition at line 1409 of file dxf.c. References DXF_COLOR_BYLAYER, DXF_DEFAULT_LAYER, DXF_DEFAULT_LINETYPE, and DXF_PAPERSPACE. Referenced by dxf_fill_polygon().

static void dxf_write_hatch_boundary_path_polyline (  FILE *  fp, int  type_flag, int  polyline_has_bulge, int  polyline_is_closed, int  polyline_vertices )  [static]

Write DXF output to a file for a hatch boundary path polyline. This entity requires AutoCAD version R14 or higher. Parameters: fp  file pointer to output device type_flag  group code 92 polyline_has_bulge  group code = 72 polyline boundary data group only polyline_is_closed  group code = 73 polyline boundary data group only polyline_vertices  group code 93 number of polyline vertices to follow Definition at line 1513 of file dxf.c. Referenced by dxf_fill_polygon().

static void dxf_write_hatch_boundary_path_polyline_vertex (  FILE *  fp, double  x0, double  y0, double  bulge )  [static]

Write DXF output to a file for a hatch boundary polyline entity. This entity requires AutoCAD version R14 or higher. Parameters: fp  file pointer to output device x0  group code = 10 X-value of vertex point y0  group code = 20 Y-value of vertex point bulge  group code 42 bulge of polyline vertex optional, defaults to 0.0 Definition at line 1544 of file dxf.c. Referenced by dxf_fill_polygon().

static void dxf_write_header (  FILE *  fp  )  [static]

Write DXF output to a file for a DXF header derived from a default header template file if available. If no default header template file is available, generate one depending on the dxf_metric variable. Write down a DXF header based on values derived from a default header template file (in pcb/src/hid/dxf/template directory). Included sections and tables are: HEADER section CLASSES section TABLES section VPORT table LTYPE table LAYER table STYLE table VIEW table UCS table APPID table DIMSTYLE table Continue from here with writing a BLOCK_RECORD table and close the section with an ENDSEC marker. Parameters: fp  file pointer to output device Definition at line 2171 of file dxf.c. References dxf_write_endsection(), dxf_write_header_imperial_new(), dxf_write_header_metric_new(), and dxf_write_table_block_record(). Referenced by dxf_export_xref_file(). Here is the call graph for this function:

static void dxf_write_header_imperial_new (  FILE *  fp  )  [static]

Write DXF output to a file for a imperial DXF header. Fall back for if no default imperial header template file exists in the pcb/src/hid/dxf/template directory. Write down a DXF header from scratch based on imperial values. Included sections and tables are: HEADER section CLASSES section TABLES section VPORT table LTYPE table LAYER table STYLE table VIEW table UCS table APPID table DIMSTYLE table Parameters: fp  file pointer to output device Definition at line 1588 of file dxf.c. Referenced by dxf_write_header().

static void dxf_write_header_metric_new (  FILE *  fp  )  [static]

Write DXF output to a file for a metric DXF header. Fall back for if no default metric header template file exists in the pcb/src/hid/dxf/template directory. Write down a DXF header from scratch based on metric values. Included sections and tables are: HEADER section CLASSES section TABLES section VPORT table LTYPE table LAYER table STYLE table VIEW table UCS table APPID table DIMSTYLE table Parameters: fp  file pointer to output device Definition at line 1638 of file dxf.c. Referenced by dxf_write_header().

static void dxf_write_insert (  FILE *  fp, int  id_code, char *  block_name, char *  linetype, char *  layer, double  x0, double  y0, double  z0, double  thickness, double  rel_x_scale, double  rel_y_scale, double  rel_z_scale, double  column_spacing, double  row_spacing, double  rot_angle, int  color, int  attribute_follows, int  paperspace, int  columns, int  rows )  [static]

Write DXF output to a file for an insert entity. Parameters: fp  file pointer to output device id_code  group code = 5 block_name  group code = 2 linetype  group code = 6 optional, if omitted defaults to BYLAYER layer  group code = 8 x0  group code = 10 base point y0  group code = 20 base point z0  group code = 30 base point thickness  group code = 39 optional, if omitted defaults to 0.0 rel_x_scale  group code = 41 optional, if omitted defaults to 1.0 rel_y_scale  group code = 42 optional, if omitted defaults to 1.0 rel_z_scale  group code = 43 optional, if omitted defaults to 1.0 column_spacing  group code = 44 optional, if omitted defaults to 0.0 row_spacing  group code = 45 optional, if omitted defaults to 0.0 rot_angle  group code = 50 optional, if omitted defaults to 0.0 color  group code = 62 optional, if omitted defaults to BYLAYER attribute_follows  group code = 66 optional, if omitted defaults to 0 paperspace  group code = 67 optional, if omitted defaults to 0 (modelspace) columns  group code = 70 optional, if omitted defaults to 1 rows  group code = 71 optional, if omitted defaults to 1 Definition at line 2238 of file dxf.c. References DXF_COLOR_BYLAYER, DXF_DEFAULT_LAYER, DXF_DEFAULT_LINETYPE, and DXF_PAPERSPACE. Referenced by dxf_export_xref_file().

static void dxf_write_polyline (  FILE *  fp, int  id_code, char *  linetype, char *  layer, double  x0, double  y0, double  z0, double  extr_x0, double  extr_y0, double  extr_z0, double  thickness, double  start_width, double  end_width, int  color, int  vertices_follow, int  paperspace, int  flag, int  polygon_mesh_M_vertex_count, int  polygon_mesh_N_vertex_count, int  smooth_M_surface_density, int  smooth_N_surface_density, int  surface_type )  [static]

Write DXF output to a file for a polyline entity. Following the Polyline header is a sequence of Vertex entities that specify the vertex coordinates and faces that compose the mesh. Vertices such as these are described in the following subsection on Vertex. Applications might want to represent polygons with an arbitrarily large number of sides in polyface meshes. However, the AutoCAD entity structure imposes a limit on the number of vertices that a given face entity can specify. You can represent more complex polygons by decomposing them into triangular wedges. Parameters: fp  file pointer to output device id_code  group code = 5 linetype  group code = 6 optional, if omitted defaults to BYLAYER layer  group code = 8 x0  group code = 10 if omitted defaults to 0.0 y0  group code = 20 if omitted defaults to 0.0 z0  group code = 30 default elevation for vertices extr_x0  group code = 210 extrusion direction optional, if ommited defaults to 0.0 extr_y0  group code = 220 extrusion direction optional, if ommited defaults to 0.0 extr_z0  group code = 230 extrusion direction optional, if ommited defaults to 1.0 thickness  group code = 39 optional, if omitted defaults to 0.0 start_width  group code = 40 optional, if omitted defaults to 0.0 end_width  group code = 41 optional, if omitted defaults to 0.0 color  group code = 62 optional, if omitted defaults to BYLAYER vertices_follow  group code = 66 mandatory, always 1 (one or more vertices make up a polyline) paperspace  group code = 67 optional, if omitted defaults to 0 (modelspace) flag  group code = 70 optional, if omitted defaults to 0 1 = This is a closed Polyline (or a polygon mesh closed in the M direction) 2 = Curve-fit vertices have been added 4 = Spline-fit vertices have been added 8 = This is a 3D Polyline 16 = This is a 3D polygon mesh. 32 = The polygon mesh is closed in the N direction 64 = This Polyline is a polyface mesh 128 = The linetype pattern is generated continuously around the vertices of this Polyline polygon_mesh_M_vertex_count  group code = 71 optional, if omitted defaults to 0 polygon_mesh_N_vertex_count  group code = 72 optional, if omitted defaults to 0 smooth_M_surface_density  group code = 73 optional, if omitted defaults to 0 smooth_N_surface_density  group code = 74 optional, if omitted defaults to 0 surface_type  group code = 75 optional, if omitted defaults to 0 integer coded, not bit-coded: 0 = no smooth surface fitted 5 = quadratic B-spline surface 6 = cubic B-spline surface 8 = Bezier surface Definition at line 2350 of file dxf.c. References DXF_COLOR_BYLAYER, DXF_DEFAULT_LAYER, DXF_DEFAULT_LINETYPE, and DXF_PAPERSPACE. Referenced by dxf_draw_arc(), dxf_draw_line(), and dxf_draw_rect().

static void dxf_write_section (  FILE *  fp, char *  section_name )  [static]

Write DXF output to a file for a section marker. Parameters: fp  file pointer to output device section_name  section name Definition at line 2449 of file dxf.c. Referenced by dxf_export_xref_file().

static void dxf_write_solid (  FILE *  fp, int  id_code, char *  linetype, char *  layer, double  x0, double  y0, double  z0, double  x1, double  y1, double  z1, double  x2, double  y2, double  z2, double  x3, double  y3, double  z3, double  thickness, int  color, int  paperspace )  [static]

Write DXF output to a file for a solid entity. Parameters: fp  file pointer to output device id_code  group code = 5 linetype  group code = 6 optional, defaults to BYLAYER layer  group code = 8 x0  group code = 10 base point X-value, bottom left y0  group code = 20 base point Y-value, bottom left z0  group code = 30 base point Z-value, bottom left x1  group code = 11 alignment point X-vaule, bottom right y1  group code = 21 alignment point Y-vaule, bottom right z1  group code = 31 alignment point Z-vaule, bottom right x2  group code = 12 alignment point X-value, top left y2  group code = 22 alignment point Y-value, top left z2  group code = 32 alignment point Z-value, top left x3  group code = 13 alignment point X-value, top right y3  group code = 23 alignment point Y-value, top right z3  group code = 33 alignment point Z-value, top right thickness  group code = 39 optional, defaults to 0.0 color  group code = 62 optional, defaults to BYLAYER paperspace  group code = 67 optional, defaults to 0 (modelspace) Definition at line 2472 of file dxf.c. References DXF_COLOR_BYLAYER, DXF_DEFAULT_LAYER, DXF_DEFAULT_LINETYPE, and DXF_PAPERSPACE. Referenced by dxf_fill_rect().

static void dxf_write_table_block_record (  FILE *  fp  )  [static]

Write DXF output to a file for a BLOCK_RECORD table. The DXF BLOCK_RECORD table is part of the TABLES section of the header that comes after the DIMSTYLE table and before the ENTITIES section. The BLOCK_RECORD table contains record definitions of all BLOCK entities, either regular BLOCK entities or external referenced BLOCK entities, the so calld XREFS. Todo: Code it !! Make it happen !! Parameters: fp  file pointer to output device Definition at line 1131 of file dxf.c. Referenced by dxf_write_header().

static void dxf_write_vertex (  FILE *  fp, int  id_code, char *  linetype, char *  layer, double  x0, double  y0, double  z0, double  thickness, double  start_width, double  end_width, double  bulge, double  curve_fit_tangent_direction, int  color, int  paperspace, int  flag )  [static]

Write DXF output to a file for a polyline vertex entity. Parameters: fp  file pointer to output device id_code  group code = 5 linetype  group code = 6 optional, if omitted defaults to BYLAYER layer  group code = 8 x0  group code = 10 y0  group code = 20 z0  group code = 30 thickness  group code = 39 optional, if omitted defaults to 0.0 start_width  group code = 40 optional, if omitted defaults to 0.0 end_width  group code = 41 optional, if omitted defaults to 0.0 bulge  group code = 42 optional, if omitted defaults to 0.0 The bulge is the tangent of 1/4 of the included angle for an arc segment. Made negative if the arc goes clockwise from the start point to the endpoint. A bulge of 0 indicates a straight segment, and a bulge of 1 is a semicircle. curve_fit_tangent_direction  group code = 50 optional, a curve-fit tangent direction of 0.0 may be omitted from the DXF output, but is significant if the flag bit is set. color  group code = 62 optional, if omitted defaults to BYLAYER paperspace  group code = 67 optional, if omitted defaults to 0 (modelspace) flag  group code = 70 optional, if omitted defaults to 0 bit coded: 1 = extra vertex created by curve-fitting 2 = curve-fit tangent defined for this vertex. 4 = unused (never set in DXF files) 8 = spline vertex created by spline-fitting 16 = spline frame control point 32 = 3D Polyline vertex 64 = 3D polygon mesh vertex 128 = polyface mesh vertex Definition at line 2534 of file dxf.c. References DXF_COLOR_BYLAYER, DXF_DEFAULT_LAYER, DXF_DEFAULT_LINETYPE, and DXF_PAPERSPACE. Referenced by dxf_draw_arc(), dxf_draw_line(), and dxf_draw_rect().

static double dxf_xy_to_angle (  double  x, double  y )  [static]

Convert pcb x,y coordinates to an angle relative to (0.0, 0.0). Definition at line 885 of file dxf.c. Referenced by dxf_export_xref_file().

void hid_dxf_init (   )

Call this as soon as possible from main(). Initialise and register the DXF HID. No other HID calls are valid until this is called. Definition at line 5176 of file dxf.c.

RCSID (  "$Id$"   )

RCS identification string.

---

Variable Documentation

int current_mask [static]

Current mask. Definition at line 484 of file dxf.c. Referenced by dxf_fill_polygon(), and dxf_use_mask().

int dxf_color_is_byblock [static]

DXF file with layer color BYBLOCK (or by layer number). Definition at line 806 of file dxf.c.

char* dxf_filename [static]

File name of layer DXF files. Definition at line 766 of file dxf.c.

char* dxf_filesuffix [static]

File name suffix for layer files. Definition at line 776 of file dxf.c.

char* dxf_header_filename [static]

File name of DXF header template file. Definition at line 771 of file dxf.c.

HID dxf_hid [static]

Record with all values of the DXF HID. Definition at line 5118 of file dxf.c.

int dxf_id_code = 0 [static]

Every DXF entity has a unique identifier (per DXF file). Definition at line 816 of file dxf.c.

int dxf_lastX [static]

The last X coordinate. Definition at line 837 of file dxf.c.

int dxf_lastY [static]

The last Y coordinate. Definition at line 842 of file dxf.c.

char* dxf_layername = 0 [static]

Layer name. Definition at line 781 of file dxf.c.

int dxf_max_pending_drills = 0

Maximum number of pending drills (holes). Definition at line 514 of file dxf.c. Referenced by dxf_fill_circle().

int dxf_metric [static]

DXF file with output in mm (not mils). Definition at line 801 of file dxf.c.

int dxf_n_pending_drills = 0

Number of pending drill (holes). Definition at line 509 of file dxf.c. Referenced by dxf_fill_circle(), and dxf_set_layer().

HID_Attribute dxf_options[] [static]

Initial value: { {"dxffile", "DXF layer filename base", HID_String, 0, 0, {0, 0, 0}, 0, 0}, #define HA_dxffile {"metric", "export DXF files in mm", HID_Boolean, 0, 0, {0, 0, 0}, 0, 0}, #define HA_metric {"layer color BYBLOCK", "export entities in color BYBLOCK", HID_Boolean, 0, 0, {0, 0, 0}, 0, 0}, #define HA_color_byblock {"xrefs", "export a DXF file with xrefs", HID_Boolean, 0, 0, {0, 0, 0}, 0, 0}, #define HA_xrefs {"xreffile", "DXF Xrefs filename", HID_String, 0, 0, {0, 0, 0}, 0, 0}, #define HA_xreffile {"verbose", "verbose output (comments)", HID_Boolean, 0, 0, {0, 0, 0}, 0, 0}, #define HA_verbose } Definition of options the user can select in the DXF exporter dialog. Definition at line 707 of file dxf.c.

DxfPendingDrills* dxf_pending_drills = 0

Pending drill (holes). Definition at line 504 of file dxf.c. Referenced by dxf_fill_circle(), and dxf_set_layer().

HID_Attr_Val dxf_values[NUM_OPTIONS] [static]

Used for HID attributes (exporting and printing, mostly). HA_boolean uses int_value, HA_enum sets int_value to the index and str_value to the enumeration string. HID_Label just shows the default str_value. HID_Mixed is a real_value followed by an enum, like 0.5in or 100mm. Definition at line 733 of file dxf.c.

int dxf_verbose [static]

DXF file with verbose output (to contain DXF comments). Definition at line 811 of file dxf.c.

char* dxf_xref_filename [static]

File name of Xref (blocks) DXF file. Definition at line 796 of file dxf.c.

int dxf_xrefs [static]

DXF file with xrefs needed. Definition at line 791 of file dxf.c.

FILE* f = 0 [static]

File pointer for DXF layer files. Definition at line 761 of file dxf.c.

int is_drill [static]

Entity is a drill (hole). Definition at line 489 of file dxf.c. Referenced by dxf_fill_circle(), dxf_set_layer(), and dxf_use_gc().

int is_mask [static]

Layer is a mask. Definition at line 479 of file dxf.c. Referenced by dxf_fill_polygon(), and dxf_use_gc().

int lncount = 0 [static]

Line count ??. Definition at line 786 of file dxf.c.

---