guidelinestousethe3ddwfpublishingapi.docVIP

Guidelines to use the 3D DWF Publishing API This document provides some guidelines for publishing 3D content to a DWF package using the DWF Toolkits 3D Publishing API. Guidelines to use the 3D DWF Publishing API 1 Basic Workflow 2 Recap of the DWF Content Definition Model 3 Generating the Scene Graph – the Model content 4 Mapping between the Content Definition and the Scene Graph 6 Basic Workflow The basic publishing workflow is as follows: Create an instance of a DWFPublisher (e.g. DWFPackagePublisher). Create an instance of a DWFPublishableSection (e.g. DWFModel). Add content (DWFPublishable types) to the section. Pass the publisher to the publish() method of the section. The publisher will process the section content according to its implementation details. Invoke the publish() method on the publisher. This will complete the process. If necessary, steps 2-4 can be repeated to add multiple sections to the package. DWFModel is a DWFPublishableSection derived class using to create 3D content for the DWF Package. The class provides a mechanism to create the 3D model and the corresponding metadata, while hiding a lot of the complexities of associated the metadata with the content. For metadata to be generated using the new content definition model, the publisher must pass a DWFContent to the DWFModel::open() call. The package’s default content can be acquired from the publisher itself. DWFFile oDWF( zOutputFile ); // Step 1 DWFPackagePublisher* pPublisher = DWFCORE_ALLOC_OBJECT( DWFPackagePublisher( oDWF ) ); DWFContent* pContent = pPublisher-getContent(); // Step 2 DWFModel* pModel = DWFCORE_ALLOC_OBJECT( DWFModel(...) ); // Step 3 pModel-open( pContent, DWFModel::eHandednessNone, DWFUnits::eCentimeters, NULL, // transform true, // default lights false, // published edges true, // silhouettes 0, DWFPublisher::ePublishContentDefinition ); ... Add Model Content ... pModel-close(); // Step 4 pM