PDF and PRC Questions

PdfExport is a common module and works with all ODA SDK formats.

PdfExport exports to .pdf format. But you can use "print" functionality.

kZoomToExtentsMode determines whether the exported drawing is in the Zoom to Extents mode. If enabled, the layout geometry is zoomed to the paper size, otherwise layout settings are applied.

So, to export a part of a drawing, you need to unset this flag and set settings relating to plot area in PlotSetting. Please refer to this blog article: Exporting part of a CAD drawing to a .pdf file. Also this article from may be useful: Export to PDF Parameters and Flags.

PdfExport is database independent product, so it can be used for any format. But your implementation has to provide some necessary protocol extensions for some entitites and should support ODA vectorization process.

Yes,this is possible with the Publish API. There is an example in OdPdfPublishEx (OdPdfPublishCADEx sample).

There is a "OdPrcPointSet" class. Example code can be found here : Prc\Examples\OdPrcCreate\RepresentationItemExample.cpp see OdPrcRepresentationItemPtr CreatePointSet(OdPrcFileStructure &newStructure).

Also you can start OdaPrcApp.exe; and few steps:

• File/New
• Tool/Load Applications
• load OdPrcExCommands.tx
• Edit/Registered Commands/Prc create example/RepresentationItemPointSet
• Vectorize it

The number of points in each OdPrcPointSet object is limited to UINT_MAX. The number of OdPrcPointSet objects is limited only by the size of the address space.

Opening files with huge number of objects can be very slow. It will depend on your hardware.

Examples of using PdfImport can be found in ODA Drawings Debug (OdaMfcApp) and our documentation.

Yes, you can set background color, for example

Code:

PDFExportParams params;
params.setBackground(ODRGB(127, 127, 127));

The result will be gray background.pdf.

VI PDF support has been discontinued.

There is another pdf module, coming for free, which is part of Kernel archives (TD_Pdfium.dll). You can read about versions in which it appears here.

ODA SDK can provide pdf with texts as pdf fonts and even if you export texts as geometry primitives, there is the option to make them searchable using pdf annotations.

If you want to export a drawing (not the export using PRC), export in shaded mode produces just picture and layers are disabled, which lies in pdf file.
There is no way to provide layers support if we export drawing as picture.

Publish SDK have no possibility to edit existing pdf files. You can only create new pdf using it.

That's because of you export the Model space in ZoomToExtents mode (even if you don't, there is the "Extents" plot area in PlotSettings. To change this, you should set the correct plot settings, like plot area - "Display", and do not use ZoomToExtents flag in pdf export flags.

You can check the drawing in the OdaMfcApp - we export the drawing as we render it. When we render it in OdaMfcApp we don't see the bricks on the walls, wood on the floor and other details. The pdf export in case of "shaded" visual style (or "realistic") is going via the rendering into picture, so the issue looks more like rendering issue and pdf export itself has no deal with it.

Right now the size (and mostly also the position) does not represent the exported geometry.

You can calculate the extents of the entities on the Model Space and try to set the paper size for the Paper Space according to them. But the paper sizes set can also contain no paper to represent your geometry correctly.

Or you can set the following plot settings:

OdDbPlotSettings *pPlotSettings = pLayout.get();
OdDbPlotSettingsValidatorPtr pValidator = pPlotSettings->database()->appServices()->plotSettingsValidator();
 
pValidator->setStdScaleType(pPlotSettings, OdDbPlotSettings::kScaleToFit);
pValidator->setPlotType(pPlotSettings, OdDbPlotSettings::kExtents);
//and optional
pValidator->setPlotCentered(pPlotSettings, true);

so your geometry will be scaled to fit the chosen paper size.

to change paper size you can use:

pPlotValidator->setCanonicalMediaName(pPlotSettings, OD_T("ISO_A1_(841.00_x_594.00_MM)"));

"ISO_A1_(841.00_x_594.00_MM)" - it is one of the many possible sizes.

In prc you can manage OdPrcMarkupTessBufText positioning only by:

Face View Mode, OdPrcMarkupTessBufFaceView
In this mode, all the drawing entities are parallel to the screen (billboard). The point given in the doubles corresponds to the origin of the new coordinate system in which entries are drawn parallel to the screen.

Frame Draw Mode, OdPrcMarkupTessBufFrame
In this mode, all the drawing entities are given in 2‐dimensional space. The point given in the doubles corresponds to a 3D point projected onto the screen, providing the origin of the 2‐dimensional coordinate system in which to draw (viewport).

Fixed Size Mode, OdPrcMarkupTessBufFixedSize
In this mode, all the drawing entities are drawn at a fixed size, independent of zoom. The point given in the doubles corresponds to the origin of the new coordinate system in which to draw at fixed size. (Adobe has porblems with supporting this mode).

Matrix Mode, OdPrcMarkupTessBufMatrix
In this mode, all the drawing entities are transformed by the matrix given in the doubles post multiplied by the current transformation matrix. At the end of the mode, the transformation matrix that was previously active is restored.

OdPrcMarkupTessPtr CreatePlainTextMarkup (OdPrcFileStructure &pCurFS)
{
//...
  pCurMkpTess = pCurMkpTess->setNext(OdPrcMarkupTessBufMatrix::createObject());
  OdGePoint3d origP(3, 3, 0);
  ((OdPrcMarkupTessBufMatrixPtr &) pCurMkpTess)->setMatrix(OdGeMatrix3d::translation(origP.asVector()));
  OdPrcMarkupTessBufTextPtr pBufText = OdPrcMarkupTessBufText::createObject();
  ODA_VERIFY(pBufText->setText(L"Markup with Text type", 20, 4) == eOk);
  ((OdPrcMarkupTessBufMatrixPtr &) pCurMkpTess)->setNextInBlock(pBufText);
//...
}

Yes, you can use the function. Code:

OdPrcCategory1LineStyle::setTransparency (OdInt8 transparency);

for the LineStyle of the corresponding object.

It's not possible. In PRC, you need to create separate PointSet objects for this purpose. But you can join them into one PartDefinition:

 ...
    OdPrcPartDefinitionPtr newDefinition = OdPrcPartDefinition::createObject();
    pPrc_FileStructure->addObject(newDefinition);
    ...
   for (int k = 0; k styleId() = OdPrcCategory1LineStyle::createByColor(getR(k), getG(k), getB(k), *pPrc_FileStructure);
     OdPrcName name;
     name.setName(<point name>);
     pPointSet->name() = name;
     pPointSet->setBehaviourBitField(PRC_GRAPHICS_Show);
     pPrc_FileStructure->addObject(pPointSet);

     pPointSet->point().push_back(OdGePoint3d(X(k), Y(k), Z(k)));
    
     newDefinition->representationItem().push_back(pPointSet->objectId());
  }

  newDefinition->setBehaviourBitField(PRC_GRAPHICS_Show); 
  pPrc_FileStructure->fileStructureTree().partDefinition().push_back(newDefinition->objectId());
  ...

OdDbRasterImageDef::sourceFileName() returns path to raster file.

This is default behavior. See viewExtents() / setViewExtents() in PdfExportParams.h

The .pdf file is actually not empty, but Adobe® software is unable to open it. If you remove '( ' from the layer name in the .pdf file, Adobe software will be able to load it.

No, but you can use free Pdfium module. More information is available here.

You can use the OdPrcFromCurvesSurface class, which implements the PRC_TYPE_SURF_FromCurves type of .prc format and then do the following:

eval_point = first_curve.evaluate(param.u) + second_curve.evaluate(param.v) – origin;

Another way is to use a NURB surface (if you have code to convert a cross section surface to a NURB surface).

Please see the OdPrcCreate example application (Prc/Examples/OdPrcCreate):

• To get sample code for creating an object of the OdPrcFromFromCuresSurface class (example case is "BrepModelFromCurves").
• To get sample code for creating an object of the OdPrcNurbsSurface class (example case is "BrepModelNURBS").

No, the prcToPdf() method does not support multi-paging. You need to use a toolkit for working with .pdf files that supports this feature. The prcToPdf() method cannot be used as a .pdf file creator; it’s purpose is to insert .prc content to a .pdf file and render it. Actually, Teigha does not contain functionality similar to a .pdf file editor.

Currently the ability to set a background color isn't provided; you can do it only at the .pdf file level. For example, if you have the following data in a .pdf file:

<<
/Type /Annot
/Subtype /3D
/Rect [0 123 594 718]
/P 2 0 R
/F 68
/Contents 9 0 R
/3DA <<
/Transparent true
/A /PO
/D /XD
>>
/3DV <<
/Type /3DView
/XN (Default View)
/MS /M
/CO 3.334073
/C2W [1.000000 0.000000 0.000000 0.000000 1.000000 0.000000 0.000000 0.000000 -1.000000 7.712374 5.931818 3.334073 ]
/P <<
/Subtype /O
/OB /Max
/OS 0.519500
>>
>>

To change the default background color:

1. Change the key /Transparent true to /Transparent false.
2. Set the new value for the background color between /CO and /C2W keys:

/BG <<
	  /C [
	    0.0
	    0.0
	    1.0
	  ]
	  /Subtype /SC
>>

Use the following code fragment as a sample:

OdDbObjectId idDefinition = pPdfRef->definitionId();
OdDbPdfDefinitionPtr pDef = idDefinition.openObject();
OdString strActiveFileName = pDef->activeFileName();
OdString strSourceFileName = pDef->sourceFileName();

This sample fragment assumes that the variable pPdfRef is a smart pointer to an instance of the OdDbPdfReference class, which has been correctly created and added to the drawing database.

When the Zoom to Extents flag is equal to false, output page parameters are taken from the layout's properties and a custom application cannot change them.

Please see the Page Setup dialog from the OdaMfcApp sample application. To open the Page Setup dialog, use File -> Page Setup from the main menu.

Yes, PDF export functionality supports creating archive .pdf documents (PDF/A). To specify a version of PDF/A format, use the PDF_A_mode enumeration from PDFExportParams class.

Currently Publish SDK supports the following versions of PDF/A format:

• PDF/A-1b
• PDF/A-2b

Transparency works correctly, but it should be enabled using plot settings when you need to export it into a .pdf file:

OdDbLayoutPtr pLayout = OdDbBlockTableRecordPtr(pDb->getActiveLayoutBTRId().safeOpenObject())->getLayoutId().safeOpenObject(OdDb::kForWrite);
pLayout->setPlotTransparency(true);
exportToPdf(pDb);

Please also remember that since version 4.2, the PDFExportParams class does not contain the kSupportTransparency flag any more.

Currently, no. As an idea to do this, merge several drawing databases into one database and export the merged database. Another idea is to export each drawing database into a separate .pdf file, then collect the output .pdf files into one file using free .pdf software.

All drawing entities can be exported in the regular way.

Please use the following code fragment as a sample:

{
  // open .prc for read and write access
  OdStreamBufPtr pPrcStream = odrxSystemServices()->createFile("\\input.prc", Oda::kFileRead, Oda::kShareDenyNo, Oda::kOpenExisting);

  // load special module
  OdPrcToPdfModulePtr pModule = ::odrxDynamicLinker()->loadModule(OdPrcToPdfModuleName, false);

  // create new .pdf file
  OdStreamBufPtr pPdf = odrxSystemServices()->createFile("\\output.pdf", Oda::kFileWrite, Oda::kShareDenyNo, Oda::kCreateAlways);

  // insert .prc to .pdf with some default paper and 3D View parameters.
  OdResult res = pModule->prcToPdf(pPrcStream, pPdf);
  ODA_ASSERT(res == eOk);
}

You can use a more complicated version of the prcToPdf() method:

virtual OdResult prcToPdf(OdStreamBufPtr pPrcStream, OdStreamBufPtr pPdfStream, const OdGsPageParams &pdfParams, const OdGeMatrix3d &C2W, double CO, double OS);

For additional information about C2W, CO and OS parameters, please see the Adobe® Portable Document Format specification.

ODA does not provide functionality for editing a .pdf file or for selecting objects in it. Please use third-party applications for these purposes.

Animation is a part of the .pdf format, but not the .prc format. Publish SDK does not provide an API for editing a .pdf file.

A .pdf file created by the prcToPdf() method contains content that is already compressed.