OdPdfImport::properties Method

Syntax

C++

virtual OdRxDictionaryPtr properties() = 0;

Returns a smart pointer to the dictionary object that contains properties used for the import of a .pdf file's content to a drawing database.

Description

Retrieves a dictionary object that contains the set of .pdf import properties.

Remarks

The list of supported properties for the PDF import operation is represented in the table below.

Property Name	Description
Database	A target database object (an instance of the OdDbDatabase class). The contents of the .pdf file are imported to this database.
PdfPath	A full path to the imported .pdf file.
Password	A password for the input .pdf file (empty by default).
PageNumber	A page number of the input .pdf file. Starts from 1 (by default).
LayersUseType	A method that determines how imported objects should be assigned to layers in the target database.
ImportVectorGeometry	A flag that determines whether the PDF geometry data types are imported (true by default).
ImportSolidFills	A flag that determines whether all solid-filled areas are imported (true by default).
ImportTrueTypeText	A flag that determines whether text objects that use TrueType fonts should be imported (true by default).
	Some symbols exported from a .pdf document may display incorrectly because the .pdf document uses symbols that the origin TrueType font does not contain.
	To correctly display all symbols, switch on the ImportTrueTypeTextAsGeometry option for the import process.
ImportRasterImages	A flag that determines whether raster images are imported by saving them as .png files and attaching them to the current drawing (true by default).
ImportGradientFills	A flag that determines whether shaded objects are imported as images by saving them as .png files and attaching them to the current drawing (true by default).
ImportAsBlock	A flag that determines whether the .pdf file is imported as a block, not as separate objects (false by default).
JoinLineAndArcSegments	A flag that determines whether contiguous segments are joined into a polyline if it is possible (true by default).
ConvertSolidsToHatches	A flag that determines whether 2D solid objects are converted into solid-filled hatches (true by default).
ApplyLineweight	A flag that determines whether lineweight properties of the imported objects remain (if true) or are ignored (if false). By default the property is equal to true.
ImportTrueTypeTextAsGeometry	A flag that determines whether text objects that use TrueType fonts are imported as polylines and solid-filled hatches (false by default).
	To import text as geometry, switch on the ImportVectorGeometry and ImportSolidFills import options.
Scaling	Specifies the scaling factor for imported objects (equal to 1.0 by default).
Rotation	Specifies the rotation angle for imported objects (equal to 0.0 by default).
InsertionPointX	An X-coordinate of the imported PDF content location relative to the location of the current UCS (equal to 0.0 by default).
InsertionPointY	A Y-coordinate of the imported PDF content location relative to the location of the current UCS (equal to 0.0 by default).
UseProgressMeter	A flag that determines whether a progress meter is used for the import (true by default). Using the progress meter can reduce performance.
UseGeometryOptimization	A flag that determines whether a geometry optimization algorithm is used for the import (true be default).
ImportType3AsTrueTypeText	A flag that determines whether text objects that use Type3 fonts are imported as objects that use TrueType fonts (false by default).
	Some symbols exported from a .pdf document may display incorrectly because the .pdf document uses Type3 font glyphs, which the origin TrueType font does not contain.
UseRgbColor	A flag that determines whether RGB colors are used or colors are selected from the palette, if possible (false by default).
ImportInvalidTTTextAsGeometry	A flag that determines whether text objects that use invalid TrueType fonts are imported as polylines and solid-filled hatches (true by default).
UseClipping	A flag that determines whether clipping support is used at import (false by default).
UsePageBorderClipping	A flag that determines whether clipping support is used at the border of the page. Only affects if UseClipping is used (false by default).
TakeAddMeasurementFactors	A flag that determines whether additional measurement factors are used for the pdf page (true by default).
CombineTextObjects	A flag that determines whether text objects that use the same font and are on the same line are combined (false by default).
CharSpaceFactor	Specifies the factor for the width of the space between characters in the word. If the distance between the test objects in the string is less
	than the width of the space taken from the font metric multiplied by this factor, the text objects are combined into one word.
	Only affects if CombineTextObjects is used (equal to 0.6 by default).
SpaceFactor	Defines the factor for the width of the space between words on a line. If the distance between the test objects in the string is
	greater than the width of the space between characters in the word (specified by CharSpaceFactor), but less than the width of the
	space taken from the font metrics multiplied by this factor, the text objects are combined into one word.
	Only affects if CombineTextObjects is used (equal to 1.5 by default).
UsePdfTransparency	A flag that determines whether transparency for geometric objects is used from a PDF stream (if true) or set to 50% for objects that will
	be imported as solid-filled areas (if false). By default the property is equal to false.

Group

OdPdfImport Methods

Send feedback about this topic