API Reference > OdPdfImport Classes > OdPdfImport Class > OdPdfImport Methods > OdPdfImport::properties Method
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.

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

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. 
ImportWidgets 
A flag that determines whether the widgets (text fields, buttons etc.) data types are imported. Widgets are imported as a set of geometric objects, solid-filled objects, images and text, so enabling options to import corresponding objects affects widget imports. By default the property is equal to true. 
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). 
UseImageClipping 
A flag that determines whether image clipping support is used at import. The image is modified on import, so that the clipped part of the image becomes transparent. 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. 
ImportHyperlinkMethod 
Defines how hyperlinks are imported. Can accept the following values: 0 - Import as a hyperlink (OdDbHyperlink) belonging to an Entity. Hyperlinks are assigned to Entities if the hyperlink's bounding box contains an entity bounding box, and the hyperlink with the smallest bounding box is selected. The others hyperlinks are ignored. 1 - Hyperlinks are imported as transparent OdDbHatch objects with assigned OdDbHyperlinks.In this case all hyperlinks are imported over other objects and according to the drawing order. 2 - Mixed method. Hyperlinks are imported as in mode "0". If the hyperlink does not match the conditions of this mode, it is imported as a transparent Hatch object with OdDbHyperlinks assigned to it. The default value is 0. 
ConsiderINSUNITS 
A flag that determines whether INSUNITS value is used when importing PDF. If true then all imported object dimensions are scaled according to the value from INSUNITS. By default the property is false. 
Type3TextDefaultFont 
The name of the font that is used when importing test objects that use the Type3 font. Can take the value of TrueType typeface name or Uni-font filename. By default the property is empty value. 
ImagePath 
String parameter that determines the directory to save the images when importing PDF. If not specified, the value of the PDFIMPORTIMAGEPATH system variable is used; if not specified and the system variable, the images are saved in the application's temporary directory. By default, the property is an empty value. 
ExtractEmbeddedFonts 
A flag that determines whether support for extracting embedded fonts is used when importing, if possible (default is false). 
EmbeddedFontsPath 
String parameter that determines the directory to extract the embedded fonts when importing PDF. If not specified, the fonts are saved in the application's temporary directory. By default, the property is an empty value. 
TryFixUnicodeTable 
A flag that determines whether ToUnicode table fixing is used for CID and Type3 fonts when importing, if possible (default is false). 
Copyright © 2002–2021. Open Design Alliance. All rights reserved.