Animation Module

Types

A3DPDFAnimTransformationData

A3DPDFAnimAppearanceData

A3DPDFAnimCameraData

A3DPDFAnimKeyFrameData

A3DPDFAnimMotionData

A3DPDFTargetEntityData

A3DPDFAnimMotionData2

A3DPDFAnimationData

Functions

A3DStatus

A3DPDFAnimKeyFrameCreate

A3DStatus

A3DPDFTargetEntityCreate

A3DStatus

A3DPDFGetEntitiesFromName

A3D_API_DEPRECATED

A3DStatus

A3DPDFAnimMotionCreate2

A3DStatus

A3DPDFAnimationCreate

A3DStatus

A3DPDF3DArtworkEditAnimationJavascript

Detailed Description

group a3d_pdf_animation_module

Module to define Animation.

This module describes the functions and structures that allow you to define 3D animations on a 3D Annot.

Function Documentation

A3DStatus A3DPDFAnimKeyFrameCreate(const A3DPDFAnimKeyFrameData *pKeyFrameData, A3DPDFAnimKeyFrame **ppKeyFrame)

Function to create a keyframe.

Version

6.1

Parameters:

  • pKeyFrameData – [in] The keyframe parameters.

  • ppKeyFrame – [out] The keyframe object created.

Return values:

A3D_SUCCESS –

Returns:

A3D_SUCCESS in case of success or an error code

A3DStatus A3DPDFTargetEntityCreate(const A3DPDFTargetEntityData *pTargetData, A3DPDFTargetEntity **ppTargetEntity)

Structure to define a target entity of a motion.

Version

7.1

Return values:
Returns:

A3D_SUCCESS in case of success or an error code

A3DStatus A3DPDFGetEntitiesFromName(A3DAsmModelFile *pModelFile, A3DInt32 iNamesSize, A3DUTF8Char **ppNames, A3DInt32 *piIndexes, A3DPDFTargetEntity ****ppTargetEntities, A3DInt32 **ppiDataSizes)

Utility function to retrieve the targets from their names.

Version

7.1

Parameters:

  • pModelFile – [in] The model file which contains the targets.

  • iNamesSize – [in] The number of names.

  • ppNames – [in] An array of names of size iNamesSize.

  • piIndexes – [in] If the targeted entity had sons, index of the son in the model file tree. Must be -1 if no sons are wanted.

  • ppTargetEntities – [out] The targeted entities retrieved. If several entities in the model file tree have the same name, all these entities are in the array.

  • ppiDataSizes – [out] For each name, the number of found entities.

Return values:

  • A3D_SUCCESS –

  • A3D_ERROR – if wrong parameters are given

Returns:

A3D_SUCCESS in case of success or an error code

Warning

doxygenfunction: Unable to resolve function “A3D_API_DEPRECATED” with arguments “None”. Candidate function could not be parsed. Parsing error is Error when parsing function declaration. If the function has no return type: Error in declarator or parameters-and-qualifiers Invalid C++ declaration: Expected identifier in nested name. [error at 60] A3D_API_DEPRECATED (A3DStatus, A3DPDFDocumentAddImageAsIcon,(A3DPDFDocument *pDoc, const A3DPDFImage *pImage, const A3DUTF8Char *pcIconName)) ————————————————————^ If the function has a return type: Error in declarator If declarator-id with parameters-and-qualifiers: Invalid C++ declaration: Expected identifier in nested name. [error at 19] A3D_API_DEPRECATED (A3DStatus, A3DPDFDocumentAddImageAsIcon,(A3DPDFDocument *pDoc, const A3DPDFImage *pImage, const A3DUTF8Char *pcIconName)) ——————-^ If parenthesis in noptr-declarator: Error in declarator or parameters-and-qualifiers If pointer to member declarator: Invalid C++ declaration: Expected ‘::’ in pointer to member (function). [error at 29] A3D_API_DEPRECATED (A3DStatus, A3DPDFDocumentAddImageAsIcon,(A3DPDFDocument *pDoc, const A3DPDFImage *pImage, const A3DUTF8Char *pcIconName)) —————————–^ If declarator-id: Invalid C++ declaration: Expecting “(” in parameters-and-qualifiers. [error at 29] A3D_API_DEPRECATED (A3DStatus, A3DPDFDocumentAddImageAsIcon,(A3DPDFDocument *pDoc, const A3DPDFImage *pImage, const A3DUTF8Char *pcIconName)) —————————–^

A3DStatus A3DPDFAnimMotionCreate2(const A3DPDFAnimMotionData2 *pMotionData, A3DPDFAnimMotion **ppAnimationMotion)

Function to create an animation motion.

Version

7.1

Parameters:

  • pMotionData – [in] The motion parameters.

  • ppAnimationMotion – [out] The motion object created.

Return values:

A3D_SUCCESS –

Returns:

A3D_SUCCESS in case of success or an error code

A3DStatus A3DPDFAnimationCreate(const A3DPDFAnimationData *pAnimationData, A3DPDFAnimation **ppAnimation)

Function to create an animation.

Version

6.1

Parameters:

  • pAnimationData – [in] The animation parameters.

  • ppAnimation – [out] The animation object created.

Return values:

  • A3D_SUCCESS –

  • A3DPDF_ANIMATION_NULL_MOTION – if one or several motions are null.

Returns:

A3D_SUCCESS in case of success or an error code

A3DStatus A3DPDF3DArtworkEditAnimationJavascript(A3DPDF3DArtwork *p3DArtwork, const A3DUTF8Char *pcJavascriptFile, A3DBool bUseAnimationFile)

Debug function to edit the JavaScript stream corresponding to the animation data in a file.

If bUseAnimationFile is set to false, the ‘standard’ JavaScript of the animation will be created from the animation data. If true, the output file will be used instead of the animation data. To use the new content, the code execution should be stopped after the call to this function, then the code modified, then the execution restarted. This function must be called before A3DPDF3DAnnotCreate.

Version

6.1

Parameters:

  • p3DArtwork – [inout] The artwork which contains the animation.

  • pcJavascriptFile – [in] The path of the file in which the JavaScript will be outputted. The content of the file can be modified by the user.

  • bUseAnimationFile – [in] If true, the modified content will be used to generate the final PDF file.

Return values:

A3D_SUCCESS –

Returns:

A3D_SUCCESS in case of success or an error code