A sample console application that exports a .dwg/.dxf file to a .pdf file with PRC format support.

The example creates a drawing database, fills it with one or several entities, and exports the drawing contents to a specified .pdf file as a PRC mesh or boundary representation. The quantity of entities and type of PRC content depends on the first application argument.

The main() function checks the input arguments, creates a custom services instance (a MyServices object), initializes the ODA Platform and makes other actions that are typical for console samples based on ODA Platform. When the initial actions are complete, the OdPdfExportWithPrcStart() function is called.

Below is the functions call schema:

main()
|
|-->OdPdfExportWithPrcStart()
    |
    |-->OdPdfExportWithPrc(OdDbHostAppServices, OdString)
    |    |
    |    |-->OdPdfExportWithPrc(OdDbHostAppServices, OdString, PDFExportParams::PRCSupport, bool, void (*fillerfunc)(OdDbDatabasePtr&))
    |        |
    |        |-->fillDatabase()
    |
    |-->OdPdfExportWithPrcSeveralEntities()
    |    |
    |    |-->OdPdfExportWithPrc(OdDbHostAppServices, OdString, PDFExportParams::PRCSupport, bool, void (*fillerfunc)(OdDbDatabasePtr&))
    |    |
    |    |-->fillDatabaseWithSeveralEntities()
    |
    |-->OdPdfPrcFilterExample()
        |
        |-->fillDatabase() in OdPdfPrcFilterExample.cpp
        |    |
        |    |-->fillDatabaseWithSeveralEntities()
        |    |
        |    |-->addFrame()
        |        |
        |        |-->addLayer()
        |        |
        |        |-->fillpoly()
        |
        |-->setupFilters()
        |
        |-->fillPdfExportParams()

Runs the OdPdfExportWithPrc(OdDbHostAppServices&, OdString) function.

Input parameters:

• OdDbHostAppServices& svcs — Reference to a custom services instance.
• OdString pdfPath — Full path to the exported .pdf file.
• ExportMode emode — Export mode that corresponds to the export case input argument.

Module: OdPdfExportWithPrcStart.cpp

The sample application contains two overrides of the OdPdfExportWithPrc function:

• OdDbHostAppServices& svcs — Reference to a custom services instance.
• OdString pdfPath — Full path to the exported .pdf file.

• OdDbHostAppServices& svcs — Reference to a custom services instance.
• OdString pdfPath — Full path to the exported .pdf file.
• PDFExportParams::PRCSupport flags — Flag that determines the kind of PRC support that should be used during the export process.
• bool shouldUseSingleViewMode — Flag that determines whether the export should use single view mode only.
• void (*fillerfunc)(OdDbDatabasePtr &pDb) — Pointer to a function that fills the database with entities.

1. Creates a PDF export module.
2. Creates and fills a database with entities (fillDatabase() function).
3. Sets export parameters.
4. Runs the export method of the exporter object.
5. Checks the result that is returned by the export method.

There are two fillDatabase() functions in different modules:

• OdPdfExportWithPrcStart.cpp file — Creates an OdDb3dSolid object and allocates it in the specified database. Input parameter:
• OdDbDatabasePtr& pDb — Reference to the drawing database where the 3D entity should be created.

Creates a new drawing database, adds to it a red box, green cylinder, blue cone and magenta torus (see the fillDatabaseWithSeveralEntities() function) and exports it to a .pdf file with PRC format support.

Input parameters:

• OdDbDatabasePtr& pDb — Reference to the drawing database where the entities should be created.
• OdString pdfPath — Full path to the output .pdf file to be created.

This function calls the OdPdfExportWithPrc() function, specifying the pointer to the fillDatabaseWithSeveralEntities() function as the last parameter.

Module: OdPdfExportWithPrcStart.cpp

Creates a red box, green cylinder, blue cone, and magenta torus, and appends these entities to the specified database.

Input parameter:

Module: OdPdfPrcFilterExample.cpp

Does the following:

1. Creates a PDF export module.
2. Creates a database and adds four 3D entities and four polylines to it.
3. Initializes and registers a filter for entities (using an instance of the PrcLayerFilter class). See PrcLayerFilter class and entity filtering implementation for information about filtering entities for export.
4. Initializes the conversion parameters.
5. Runs the export procedure for the drawing database and checks the result.

Input parameters:

Module: OdPdfPrcFilterExample.cpp

Creates four squares centered at the origin (for creating each polyline the fillpoly() function is called):

1. Opens model space for writing.
2. Adds a frame with the name "Frame" to model space (calls the addLayer() function).
3. Creates four polylines and fills them with vertexes (using the fillpoly() function).
4. Adds created polylines to the layer "Frame".
5. Adds four polylines to the model space block table record.

Input parameter:

Module: OdPdfPrcFilterExample.cpp

Adds a new layer to a specified drawing:

1. Opens the layer table for writing.
2. Creates a new layer table record.
3. Sets the layer's name (you must specify layer name before adding it to the table).
4. Adds the new record to the layer table.

Input parameters:

Module: OdPdfPrcFilterExample.cpp

Creates a square centered at the origin by adding vertexes to a specified polyline. Newly created vertices have the following coordinates (x, y), (x, y2), (x2, y2), (x, y).

Input parameters:

Registers the PrcLayerFilter class in the ODA Platform environment.

The PrcLayerFilter class implements filtering functionality. For additional information, see PrcLayerFilter class and entity filtering implementation.

Sets .pdf file export parameters:

1. Creates an output .pdf file
2. Sets export parameters to the passed instance of the PDFExportParams class:
   • Database
   • Authoring version
   • Output .pdf file
   • Default export flags
   • Title
   • Authorizing application title
   • PDF document title
   • PRC export context (with filtering object)
     For details see PrcLayerFilter class and entity filtering implementation.
3. Adds the Model layout to the list of exported layouts.
4. Sets the printing page size and margins (default values: A4 paper size and zero margins).

Input parameters:

PrcLayerFilter overrides the shouldExportAsPRC() method to determine whether a graphical entity should be exported to PRC format.

Input parameters of the shouldExportAsPRC() method:

1. Tries to cast a graphical object (OdGiDrawable object) pointer to a database entity smart pointer. In the other words, tries to find out whether the graphical object represents a drawing database entity.
2. If a graphical object represents a database entity and this entity does not belong to the layer with the name "Frame", it is exported to a PRC view. In the other case it is exported to a .pdf page.

Therefore, the squares created in the addFrame() function that are located on the "Frame" layer will be exported to a .pdf page, not to a PRC view.