Class: QgsDxfExport¶

Exports QGIS layers to the DXF format.

Enums

`ExportResult`	The result of an export as dxf operation
`HAlign`	Horizontal alignments.
`SymbologyExport`	alias of `FeatureSymbologyExport`
`VAlign`	Vertical alignments.

Methods

`addLayers`	Add layers to export
`clipValueToMapUnitScale`	Clips value to scale minimum/maximum
`destinationCrs`	Returns the destination CRS, or an invalid CRS if no reprojection will be done.
`extent`	Gets extent of area to export
`feedbackMessage`	Returns any feedback message produced while export to dxf file.
`flags`	Returns the export flags.
`force2d`	Retrieve whether the output should be forced to 2d
`layerName`	Gets layer name for feature
`layerTitleAsName`	Retrieve whether layer title (where set) instead of name shall be use
`mapUnits`	Retrieve map units
`registerDxfLayer`	Register name of layer for feature
`setDestinationCrs`	Set destination CRS
`setExtent`	Set extent of area to export
`setFlags`	Sets the export flags.
`setForce2d`	Force 2d output (eg.
`setLayerTitleAsName`	Enable use of title (where set) instead of layer name, when attribute index of corresponding layer index is -1
`setMapSettings`	Set map settings and assign layer name attributes
`setSymbologyExport`	Set symbology export mode
`setSymbologyScale`	Set reference scale for output.
`symbologyExport`	Gets symbology export mode
`symbologyScale`	Returns the reference scale for output.
`writeCircleV2`	Write circle (as polyline)
`writeDouble`	Write a floating point value
`writeFillCircleV2`	Write filled circle (as hatch)
`writeGroup`	Write a group code with a string value
`writeGroupCode`	Write a group code
`writeGroupDouble`	Write a group code with a floating point value
`writeGroupInt`	Write a tuple of group code and integer value
`writeGroupLong`	Write a tuple of group code and long value
`writeGroupPointV2`	Write a group code with a point
`writeHandle`	Write a tuple of group code and a handle
`writeInt`	Write an integer value
`writeLine`	Write line (as a polyline)
`writeMText`	Write mtext (MTEXT)
`writePointV2`	Write point
`writeString`	Write a string value
`writeTextV2`	Write text (TEXT)
`writeToFile`

Static Methods

`closestColorMatch`	Gets DXF palette index of nearest entry for given color
`dxfEncoding`	Returns DXF encoding for Qt encoding
`dxfLayerName`	Returns cleaned layer name for use in DXF
`encodings`	Returns list of available DXF encodings
`mapUnitScaleFactor`	Returns scale factor for conversion to map units

Attributes

`Closed`
`ContinuousPattern`
`Curve`
`FlagHairlineWidthExport`
`FlagNoMText`
`FlagOnlySelectedFeatures`
`Is3DPolygonMesh`
`Is3DPolyline`
`PolyfaceMesh`
`PolygonMesh`
`Spline`

class qgis.core.QgsDxfExport[source]¶

Bases: object

__init__(): Constructor for QgsDxfExport.

Closed = 1¶

ContinuousPattern = 128¶

Curve = 2¶

class DxfLayer¶

Bases: object

Layers and optional attribute index to split into multiple layers using attribute value as layer name.

buildDataDefinedBlocks(self) → bool¶

Flag if data defined point block symbols should be created. Default is false

Return type:: bool
Returns:: True if data defined point block symbols should be created

Added in version 3.38.

dataDefinedBlocksMaximumNumberOfClasses(self) → int¶

Returns the maximum number of data defined symbol classes for which blocks are created. Returns -1 if there is no such limitation

Return type:: int
Returns:

Added in version 3.38.

layer(self) → QgsVectorLayer | None¶

Returns the layer

Return type:: Optional[QgsVectorLayer]

layerOutputAttributeIndex(self) → int¶

Returns the attribute index used to split into multiple layers. The attribute value is used for layer names.

See also

splitLayerAttribute()

Return type:: int

overriddenName(self) → str¶

Returns the overridden layer name to be used in the exported DXF.

Added in version 3.38.

Return type:: str

splitLayerAttribute(self) → str¶

If the split layer attribute is set, the vector layer will be split into several dxf layers, one per each unique value.

Added in version 3.12.

Return type:: str

class DxfPolylineFlag¶: Bases: int

class DxfPolylineFlags¶
class DxfPolylineFlags(f: QgsDxfExport.DxfPolylineFlags | QgsDxfExport.DxfPolylineFlag)
class DxfPolylineFlags(a0: QgsDxfExport.DxfPolylineFlags): Bases: object

class ExportResult(*values)¶

Bases: IntEnum

The result of an export as dxf operation

Added in version 3.10.1.

Success: Successful export
InvalidDeviceError: Invalid device error
DeviceNotWritableError: Device not writable error
EmptyExtentError: Empty extent, no extent given and no extent could be derived from layers

DeviceNotWritableError = 2¶

EmptyExtentError = 3¶

InvalidDeviceError = 1¶

Success = 0¶

class Flag¶: Bases: int

FlagHairlineWidthExport = 8¶

FlagNoMText = 2¶

FlagOnlySelectedFeatures = 4¶

class Flags¶
class Flags(f: QgsDxfExport.Flags | QgsDxfExport.Flag)
class Flags(a0: QgsDxfExport.Flags): Bases: object

class HAlign(*values)¶

Bases: IntEnum

Horizontal alignments.

HLeft: Left (0)
HCenter: Centered (1)
HRight: Right (2)
HAligned: Aligned = (3) (if VAlign==0)
HMiddle: Middle = (4) (if VAlign==0)
HFit: Fit into point = (5) (if VAlign==0)
Undefined: Undefined

HAligned = 3¶

HCenter = 1¶

HFit = 5¶

HLeft = 0¶

HMiddle = 4¶

HRight = 2¶

Undefined = 9999¶

Is3DPolygonMesh = 16¶

Is3DPolyline = 8¶

PolyfaceMesh = 64¶

PolygonMesh = 32¶

Spline = 4¶

SymbologyExport¶: alias of FeatureSymbologyExport

class VAlign(*values)¶

Bases: IntEnum

Vertical alignments.

VBaseLine: Top (0)
VBottom: Bottom (1)
VMiddle: Middle (2)
VTop: Top (3)
Undefined: Undefined

Undefined = 9999¶

VBaseLine = 0¶

VBottom = 1¶

VMiddle = 2¶

VTop = 3¶

addLayers(self, layers: Iterable[QgsDxfExport.DxfLayer])[source]¶

Add layers to export

Parameters:: layers (Iterable[QgsDxfExport.DxfLayer]) – list of layers and corresponding attribute indexes that determine the layer name (-1 for original layer name or title)

See also

setLayerTitleAsName()

clipValueToMapUnitScale(self, scale: QgsMapUnitScale, pixelToMMFactor: float) → float[source]¶

Clips value to scale minimum/maximum

Parameters:

value – the value to clip
scale (QgsMapUnitScale) – the scale dependent minimum/maximum values
pixelToMMFactor (float) – pixels per mm

Return type:

float

static closestColorMatch(color: int) → int[source]¶

Gets DXF palette index of nearest entry for given color

Parameters:: color (int)
Return type:: int

destinationCrs(self) → QgsCoordinateReferenceSystem[source]¶

Returns the destination CRS, or an invalid CRS if no reprojection will be done.

See also

setDestinationCrs()

Return type:: QgsCoordinateReferenceSystem

static dxfEncoding(name: str | None) → str[source]¶

Returns DXF encoding for Qt encoding

Parameters:: name (Optional[str])
Return type:: str

static dxfLayerName(name: str | None) → str[source]¶

Returns cleaned layer name for use in DXF

Parameters:: name (Optional[str])
Return type:: str

static encodings() → List[str][source]¶

Returns list of available DXF encodings

Return type:: List[str]

extent(self) → QgsRectangle[source]¶

Gets extent of area to export

Return type:: QgsRectangle
Returns:: area to export

See also

setExtent()

feedbackMessage(self) → str[source]¶

Returns any feedback message produced while export to dxf file.

Added in version 3.36.

Return type:: str

flags(self) → QgsDxfExport.Flags[source]¶

Returns the export flags.

See also

setFlags()

Return type:: QgsDxfExport.Flags

force2d(self) → bool[source]¶

Retrieve whether the output should be forced to 2d

Return type:: bool
Returns:: flag

See also

setForce2d()

layerName(self, id: str | None, f: QgsFeature) → str[source]¶

Gets layer name for feature

Parameters:

id (Optional[str]) – layer id of layer
f (QgsFeature) – feature of layer

Return type:

str

Returns:

layer name for feature

layerName(self, vl: QgsVectorLayer | None) → str[source]

Gets name for layer respecting the use layer title as layer name mode

Parameters:: vl (Optional[QgsVectorLayer]) – the vector layer
Return type:: str
Returns:: name of layer

See also

setLayerTitleAsName()

layerTitleAsName(self) → bool[source]¶

Retrieve whether layer title (where set) instead of name shall be use

Return type:: bool
Returns:: flag

See also

setLayerTitleAsName()

static mapUnitScaleFactor(scale: float, symbolUnits: Qgis.RenderUnit, mapUnits: Qgis.DistanceUnit, mapUnitsPerPixel: float = 1) → float[source]¶

Returns scale factor for conversion to map units

Parameters:

scale (float) – the map scale denominator
symbolUnits (Qgis.RenderUnit) – the symbol output units
mapUnits (Qgis.DistanceUnit) – the map units
mapUnitsPerPixel (float = 1) – Map units per pixel

Return type:

float

mapUnits(self) → Qgis.DistanceUnit[source]¶

Retrieve map units

Return type:: Qgis.DistanceUnit
Returns:: unit

registerDxfLayer(self, layerId: str | None, fid: int, layer: str | None)[source]¶

Register name of layer for feature

Parameters:

layerId (Optional[str]) – id of layer
fid (int) – id of feature
layer (Optional[str]) – dxf layer of feature

Deprecated since version 3.40: Will be made private in QGIS 4.

setDestinationCrs(self, crs: QgsCoordinateReferenceSystem)[source]¶

Set destination CRS

See also

destinationCrs()

Parameters:: crs (QgsCoordinateReferenceSystem)

setExtent(self, r: QgsRectangle)[source]¶

Set extent of area to export

Parameters:: r (QgsRectangle) – area to export

setFlags(self, flags: QgsDxfExport.Flags | QgsDxfExport.Flag)[source]¶

Sets the export flags.

See also

flags()

Parameters:: flags (Union[QgsDxfExport.Flags, QgsDxfExport.Flag])

setForce2d(self, force2d: bool)[source]¶

Force 2d output (eg. to support linewidth in polylines)

Parameters:: force2d (bool) – flag

See also

force2d()

setLayerTitleAsName(self, layerTitleAsName: bool)[source]¶

Enable use of title (where set) instead of layer name, when attribute index of corresponding layer index is -1

Parameters:: layerTitleAsName (bool) – flag

See also

addLayers()

setMapSettings(self, settings: QgsMapSettings)[source]¶

Set map settings and assign layer name attributes

Parameters:: settings (QgsMapSettings) – map settings to apply

setSymbologyExport(self, e: Qgis.FeatureSymbologyExport)[source]¶

Set symbology export mode

Parameters:: e (Qgis.FeatureSymbologyExport) – the mode

setSymbologyScale(self, scale: float)[source]¶

Set reference scale for output. The scale value indicates the scale denominator, e.g. 1000.0 for a 1:1000 map.

See also

symbologyScale()

Parameters:: scale (float)

symbologyExport(self) → Qgis.FeatureSymbologyExport[source]¶

Gets symbology export mode

Return type:: Qgis.FeatureSymbologyExport
Returns:: mode

See also

setSymbologyExport()

symbologyScale(self) → float[source]¶

Returns the reference scale for output. The scale value indicates the scale denominator, e.g. 1000.0 for a 1:1000 map.

See also

setSymbologyScale()

Return type:: float

writeCircleV2(self, layer: str | None, color: QColor | Qt.GlobalColor, pt: QgsPoint, radius: float, lineStyleName: str | None, width: float)¶

Write circle (as polyline)

Parameters:

layer (Optional[str])
color (Union[QColor, Qt.GlobalColor])
pt (QgsPoint)
radius (float)
lineStyleName (Optional[str])
width (float)

writeDouble(self, d: float)[source]¶

Write a floating point value

Parameters:: d (float) – floating point value

writeFillCircleV2(self, layer: str | None, color: QColor | Qt.GlobalColor, pt: QgsPoint, radius: float)¶

Write filled circle (as hatch)

Note

available in Python bindings as writePointV2

Parameters:

layer (Optional[str])
color (Union[QColor, Qt.GlobalColor])
pt (QgsPoint)
radius (float)

writeGroup(self, code: int, s: str | None)[source]¶

Write a group code with a string value

Parameters:

code (int) – group code
s (Optional[str]) – string value

writeGroup(self, color: QColor | Qt.GlobalColor, exactMatch: int = 62, rgbCode: int = 420, transparencyCode: int = 440)[source]

Write a group code with color value

Parameters:

color (Union[QColor, Qt.GlobalColor]) – color
exactMatch (int = 62) – group code to use if the color has an exact match in the dxf palette
rgbCode (int = 420) – group code to use if the color doesn’t have an exact match or has a transparency component
transparencyCode (int = 440) – group code to use for transparency component

Note

available in Python bindings as writeGroupPoint

writeGroupCode(self, code: int)[source]¶

Write a group code

Parameters:: code (int) – group code value

writeGroupDouble(self, code: int, d: float)¶

Write a group code with a floating point value

Parameters:

code (int) – group code
d (float) – floating point value

writeGroupInt(self, code: int, i: int)¶

Write a tuple of group code and integer value

Parameters:

code (int) – group code
i (int) – integer value

writeGroupLong(self, code: int, i: int)¶

Write a tuple of group code and long value

Parameters:

code (int) – group code
i (int) – integer value

writeGroupPointV2(self, code: int, p: QgsPoint)¶

Write a group code with a point

Parameters:

code (int) – group code
p (QgsPoint) – point value

writeHandle(self, code: int = 5, handle: int = 0) → int[source]¶

Write a tuple of group code and a handle

Parameters:

code (int = 5) – group code to use
handle (int = 0) – handle to use (0 generates a new handle)

Return type:

int

Returns:

the used handle

writeInt(self, i: int)[source]¶

Write an integer value

Parameters:: i (int) – integer value

writeLine(self, pt1: QgsPoint, pt2: QgsPoint, layer: str | None, lineStyleName: str | None, color: QColor | Qt.GlobalColor, width: float = -1)[source]¶

Write line (as a polyline)

Parameters:

pt1 (QgsPoint)
pt2 (QgsPoint)
layer (Optional[str])
lineStyleName (Optional[str])
color (Union[QColor, Qt.GlobalColor])
width (float = -1)

writeMText(self, layer: str | None, text: str | None, pt: QgsPoint, width: float, angle: float, color: QColor | Qt.GlobalColor)[source]¶

Write mtext (MTEXT)

Note

available in Python bindings as writeMTextV2

Parameters:

layer (Optional[str])
text (Optional[str])
pt (QgsPoint)
width (float)
angle (float)
color (Union[QColor, Qt.GlobalColor])

writePointV2(self, layer: str | None, color: QColor | Qt.GlobalColor, pt: QgsPoint)¶

Write point

Parameters:

layer (Optional[str])
color (Union[QColor, Qt.GlobalColor])
pt (QgsPoint)

writeString(self, s: str | None)[source]¶

Write a string value

Parameters:: s (Optional[str]) – string value

writeTextV2(self, layer: str | None, text: str | None, pt: QgsPoint, size: float, angle: float, color: QColor | Qt.GlobalColor, hali: QgsDxfExport.HAlign = QgsDxfExport.HAlign.Undefined, vali: QgsDxfExport.VAlign = QgsDxfExport.VAlign.Undefined)¶

Write text (TEXT)

Parameters:

layer (Optional[str])
text (Optional[str])
pt (QgsPoint)
size (float)
angle (float)
color (Union[QColor, Qt.GlobalColor])
hali (QgsDxfExport.HAlign = QgsDxfExport.HAlign.Undefined)
vali (QgsDxfExport.VAlign = QgsDxfExport.VAlign.Undefined)

writeToFile(self, d: QIODevice | None, codec: str | None) → QgsDxfExport.ExportResult[source]¶

Parameters:

d (Optional[QIODevice])
codec (Optional[str])

Return type:

QgsDxfExport.ExportResult