A3DSDKMarkup.h
Header file for the markup module.
- Author
Tech Soft 3D
- Version
23.0
- Date
January 2023
- Copyright (c) 2010 - 2023 by Tech Soft 3D, Inc. All rights reserved.
Content
Data Structures
Markup Leader structure. |
|
Annotation Item structure. |
|
Annotation Set structure. |
|
Annotation Reference structure. |
|
View structure. |
|
The set of activated components in a View. |
|
Markup Linked Item structure. |
|
Markup structure. |
|
Structure used to parse RTF strings. |
|
Font key structure. |
|
Font structure. |
Type definitions
Entity type for RTF Field. |
|
Functions
Populates the A3DMkpLeaderData structure. |
|
Creates an A3DMkpLeader from an A3DMkpLeaderData structure. |
|
Populates the A3DMkpAnnotationItemData structure. |
|
Creates an A3DMkpAnnotationItem from an A3DMkpAnnotationItemData structure. |
|
Populates the A3DMkpAnnotationSetData structure. |
|
Creates an A3DMkpAnnotationSet from an A3DMkpAnnotationSetData structure. |
|
Populates the A3DMkpAnnotationReferenceData structure. |
|
Creates an A3DMkpAnnotationReference from an A3DMkpAnnotationReferenceData structure. |
|
Populates the A3DMkpViewData structure. |
|
Creates an A3DMkpView from an A3DMkpViewData structure. |
|
Returns the set of components for a view using a A3DMkpViewFlagsData . |
|
Populates the A3DMiscMarkupLinkedItemData structure. |
|
Creates an A3DMiscMarkupLinkedItem from an A3DMiscMarkupLinkedItemData structure. |
|
Populates the A3DMkpMarkupData structure. |
|
Creates the A3DMkpMarkup from A3DMkpMarkupData structure. |
|
Get links corresponding to the A3DMkpMarkup references This function allocates and returns an array of A3DMiscMarkupLinkedItem . |
|
Get links corresponding to the A3DMkpMarkup additional references such as element defining the toleranced line for line profile. |
|
Initialize RTF data for parsing Previously A3DMkpRTFInit. |
|
Initialize RTF data for parsing. |
|
Get each independent field of a RTF data Previously A3DMkpRTFGetField. |
|
Get each independent field of a RTF data. |
|
delete RTF data created by A3DMkpRTFInit Previously A3DMkpRTFDelete. |
|
delete RTF data created by A3DMkpRTFInit |
|
Retrieves font information ( A3DFontData ) from the A3DFontKeyData structure. |
|
Gets text bounding box according to the font. |
|
Gets text bounding box and scale according to the font. |
|
Creates the A3DFontKeyData structure from the A3DFontData structure. |
|
Gets text tessellation as wireframe. |
Type definitions
-
typedef void A3DMkpRTFField
Entity type for RTF Field.
Data is A3DMkpRTFFieldData
-
typedef A3DMkpRTFFieldData A3DRTFFieldData
- Deprecated:
This type is deprecated. Please use the A3DRTFFieldData to implement the same behaviour.
Functions
-
A3DStatus A3DMkpLeaderGet(const A3DMkpLeader *pLeader, A3DMkpLeaderData *pData)
Populates the A3DMkpLeaderData structure.
- Version
2.0
- Return values
A3D_INITIALIZE_NOT_CALLED –
A3D_INVALID_DATA_STRUCT_SIZE –
A3D_INVALID_DATA_STRUCT_NULL –
A3D_INVALID_ENTITY_NULL –
A3D_INVALID_ENTITY_TYPE –
A3D_SUCCESS –
- Returns
A3D_SUCCESS in case of success or an error code
-
A3DStatus A3DMkpLeaderCreate(const A3DMkpLeaderData *pData, A3DMkpLeader **ppLeader)
Creates an A3DMkpLeader from an A3DMkpLeaderData structure.
- Version
2.0
- Return values
A3D_INVALID_DATA_STRUCT_SIZE –
A3D_INVALID_DATA_STRUCT_NULL –
A3D_SUCCESS –
- Returns
A3D_SUCCESS in case of success or an error code
-
A3DStatus A3DMkpAnnotationItemGet(const A3DMkpAnnotationItem *pAnnotation, A3DMkpAnnotationItemData *pData)
Populates the A3DMkpAnnotationItemData structure.
- Version
2.0
- Return values
A3D_INITIALIZE_NOT_CALLED –
A3D_INVALID_DATA_STRUCT_SIZE –
A3D_INVALID_DATA_STRUCT_NULL –
A3D_INVALID_ENTITY_NULL –
A3D_INVALID_ENTITY_TYPE –
A3D_SUCCESS –
- Returns
A3D_SUCCESS in case of success or an error code
-
A3DStatus A3DMkpAnnotationItemCreate(const A3DMkpAnnotationItemData *pData, A3DMkpAnnotationItem **ppAnnotation)
Creates an A3DMkpAnnotationItem from an A3DMkpAnnotationItemData structure.
- Version
2.0
- Return values
A3D_INVALID_DATA_STRUCT_SIZE –
A3D_INVALID_DATA_STRUCT_NULL –
A3D_SUCCESS –
- Returns
A3D_SUCCESS in case of success or an error code
-
A3DStatus A3DMkpAnnotationSetGet(const A3DMkpAnnotationSet *pAnnotation, A3DMkpAnnotationSetData *pData)
Populates the A3DMkpAnnotationSetData structure.
- Version
2.0
- Return values
A3D_INITIALIZE_NOT_CALLED –
A3D_INVALID_DATA_STRUCT_SIZE –
A3D_INVALID_DATA_STRUCT_NULL –
A3D_INVALID_ENTITY_NULL –
A3D_INVALID_ENTITY_TYPE –
A3D_SUCCESS –
- Returns
A3D_SUCCESS in case of success or an error code
-
A3DStatus A3DMkpAnnotationSetCreate(const A3DMkpAnnotationSetData *pData, A3DMkpAnnotationSet **ppAnnotation)
Creates an A3DMkpAnnotationSet from an A3DMkpAnnotationSetData structure.
- Version
2.0
- Return values
A3D_INVALID_DATA_STRUCT_SIZE –
A3D_INVALID_DATA_STRUCT_NULL –
A3D_ANNOTATIONSET_WITH_NULL_ELEMENT –
A3D_SUCCESS –
- Returns
A3D_SUCCESS in case of success or an error code
-
A3DStatus A3DMkpAnnotationReferenceGet(const A3DMkpAnnotationReference *pAnnotation, A3DMkpAnnotationReferenceData *pData)
Populates the A3DMkpAnnotationReferenceData structure.
- Version
2.0
- Return values
A3D_INITIALIZE_NOT_CALLED –
A3D_INVALID_DATA_STRUCT_SIZE –
A3D_INVALID_DATA_STRUCT_NULL –
A3D_INVALID_ENTITY_NULL –
A3D_INVALID_ENTITY_TYPE –
A3D_SUCCESS –
- Returns
A3D_SUCCESS in case of success or an error code
-
A3DStatus A3DMkpAnnotationReferenceCreate(const A3DMkpAnnotationReferenceData *pData, A3DMkpAnnotationReference **ppAnnotation)
Creates an A3DMkpAnnotationReference from an A3DMkpAnnotationReferenceData structure.
- Version
2.0
- Return values
A3D_INVALID_DATA_STRUCT_SIZE –
A3D_INVALID_DATA_STRUCT_NULL –
A3D_SUCCESS –
- Returns
A3D_SUCCESS in case of success or an error code
-
A3DStatus A3DMkpViewGet(const A3DMkpView *pView, A3DMkpViewData *pData)
Populates the A3DMkpViewData structure.
- Version
2.0
- Return values
A3D_INITIALIZE_NOT_CALLED –
A3D_INVALID_DATA_STRUCT_SIZE –
A3D_INVALID_DATA_STRUCT_NULL –
A3D_INVALID_ENTITY_NULL –
A3D_INVALID_ENTITY_TYPE –
A3D_SUCCESS –
- Returns
A3D_SUCCESS in case of success or an error code
-
A3DStatus A3DMkpViewCreate(const A3DMkpViewData *pData, A3DMkpView **ppView)
Creates an A3DMkpView from an A3DMkpViewData structure.
- Version
2.0
- Return values
A3D_INVALID_DATA_STRUCT_SIZE –
A3D_INVALID_DATA_STRUCT_NULL –
A3D_SUCCESS –
- Returns
A3D_SUCCESS in case of success or an error code
-
A3DStatus A3DMkpViewGetFlags(const A3DMkpView *pView, A3DMkpViewFlagsData *pFlags)
Returns the set of components for a view using a A3DMkpViewFlagsData.
- Version
7.1
- Parameters
pView – [in] The view to get components info from.
pFlags – [out] The set of flags to write in.
- Return values
A3D_INVALID_DATA_STRUCT_NULL –
A3D_SUCCESS –
- Returns
A3D_SUCCESS in case of success or an error code
-
A3DStatus A3DMiscMarkupLinkedItemGet(const A3DMiscMarkupLinkedItem *pLinkedItem, A3DMiscMarkupLinkedItemData *pData)
Populates the A3DMiscMarkupLinkedItemData structure.
- Version
2.0
- Return values
A3D_INITIALIZE_NOT_CALLED –
A3D_INVALID_DATA_STRUCT_SIZE –
A3D_INVALID_DATA_STRUCT_NULL –
A3D_INVALID_ENTITY_NULL –
A3D_INVALID_ENTITY_TYPE –
A3D_SUCCESS –
- Returns
A3D_SUCCESS in case of success or an error code
-
A3DStatus A3DMiscMarkupLinkedItemCreate(const A3DMiscMarkupLinkedItemData *pData, A3DMiscMarkupLinkedItem **ppLinkedItem)
Creates an A3DMiscMarkupLinkedItem from an A3DMiscMarkupLinkedItemData structure.
- Version
2.0
- Return values
A3D_INVALID_DATA_STRUCT_SIZE –
A3D_INVALID_DATA_STRUCT_NULL –
A3D_INVALID_ENTITY_TYPE – if A3DMiscMarkupLinkedItemData::m_pReference is not of a valid type
A3D_SUCCESS –
- Returns
A3D_SUCCESS in case of success or an error code
-
A3DStatus A3DMkpMarkupGet(const A3DMkpMarkup *pMarkup, A3DMkpMarkupData *pData)
Populates the A3DMkpMarkupData structure.
- Version
2.0
- Return values
A3D_INITIALIZE_NOT_CALLED –
A3D_INVALID_DATA_STRUCT_SIZE –
A3D_INVALID_DATA_STRUCT_NULL –
A3D_INVALID_ENTITY_NULL –
A3D_INVALID_ENTITY_TYPE –
A3D_SUCCESS –
- Returns
A3D_SUCCESS in case of success or an error code
-
A3DStatus A3DMkpMarkupCreate(const A3DMkpMarkupData *pData, A3DMkpMarkup **ppMarkup)
Creates the A3DMkpMarkup from A3DMkpMarkupData structure.
- Version
2.0
- Return values
A3D_INVALID_DATA_STRUCT_SIZE –
A3D_INVALID_DATA_STRUCT_NULL –
A3D_SUCCESS –
- Returns
A3D_SUCCESS in case of success or an error code
-
A3DStatus A3DMkpLinkForMarkupReferenceGet(const A3DMkpMarkup *pMarkup, A3DUns32 *puiLinkedItemsSize, A3DMiscMarkupLinkedItem ***ppLinkedItems)
Get links corresponding to the A3DMkpMarkup references This function allocates and returns an array of A3DMiscMarkupLinkedItem.
To free the allocated array, the function must be called again with pMarkup as NULL.
Remark
Internally there are several types of links such as reference, position, additional reference, owner or datum.This function only returns the reference links.
- Version
6.0
- Parameters
pMarkup – [in] The A3DMkpMarkup entity to get linked item list from. If NULL, pppLinkedItems is freed instead of being allocated.
puiLinkedItemsSize – [out] The number of A3DMiscMarkupLinkedItem in the resulting array.
ppLinkedItems – [out] The resulting array.
- Return values
A3D_INITIALIZE_NOT_CALLED –
A3D_INVALID_DATA_STRUCT_SIZE –
A3D_INVALID_DATA_STRUCT_NULL –
A3D_INVALID_ENTITY_NULL –
A3D_INVALID_ENTITY_TYPE –
A3D_SUCCESS –
- Returns
A3D_SUCCESS in case of success or an error code
-
A3DStatus A3DMkpLinkForAdditionalMarkupReferenceGet(const A3DMkpMarkup *pMarkup, A3DUns32 *puiLinkedItemsSize, A3DMiscMarkupLinkedItem ***pppLinkedItems)
Get links corresponding to the A3DMkpMarkup additional references such as element defining the toleranced line for line profile.
This function allocates and returns an array of A3DMiscMarkupLinkedItem. To free the allocated array, the function must be called again with pMarkup as NULL.
Remark
Internally there are several types of links such as reference, position, additional reference, owner or datum.This function only returns the additional reference links.
- Version
6.0
- Version
9.0
- Parameters
pMarkup – [in] The A3DMkpMarkup entity to get linked item list from. If NULL, pppLinkedItems is freed instead of being allocated.
puiLinkedItemsSize – [out] The number of A3DMiscMarkupLinkedItem in the resulting array.
pppLinkedItems – [out] The resulting array.
- Return values
A3D_INITIALIZE_NOT_CALLED –
A3D_INVALID_DATA_STRUCT_SIZE –
A3D_INVALID_DATA_STRUCT_NULL –
A3D_INVALID_ENTITY_NULL –
A3D_INVALID_ENTITY_TYPE –
A3D_SUCCESS –
- Returns
A3D_SUCCESS in case of success or an error code
-
A3DStatus A3DMkpRTFFieldCreate(const A3DUTF8Char *pRTFString, A3DMkpRTFField **pRTFField)
Initialize RTF data for parsing Previously A3DMkpRTFInit.
- Version
10.1
- Return values
A3D_ERROR –
A3D_SUCCESS –
- Returns
A3D_SUCCESS in case of success or an error code
-
A3DStatus A3DMkpRTFInit(const A3DUTF8Char *pRTF, A3DVoid **pRTFData)
Initialize RTF data for parsing.
- Deprecated:
This function is deprecated. Please use the A3DMkpRTFFieldCreate to implement the same behaviour.
- Version
4.2
- Return values
A3D_ERROR –
A3D_SUCCESS –
- Returns
A3D_SUCCESS in case of success or an error code
-
A3DStatus A3DMkpRTFFieldGet(const A3DMkpRTFField *pRTFField, A3DMkpRTFFieldData *pRTFFieldData)
Get each independent field of a RTF data Previously A3DMkpRTFGetField.
- Version
10.1
- Return values
A3D_ERROR –
A3D_SUCCESS –
- Returns
A3D_SUCCESS in case of success or an error code
-
A3DStatus A3DMkpRTFGetField(A3DVoid *pRTFData, A3DRTFFieldData *pRTFField)
Get each independent field of a RTF data.
- Deprecated:
This function is deprecated. Please use the A3DMkpRTFFieldGet to implement the same behaviour.
- Version
4.2
- Return values
A3D_ERROR –
A3D_SUCCESS –
- Returns
A3D_SUCCESS in case of success or an error code
-
A3DStatus A3DMkpRTFFieldDelete(const A3DMkpRTFField *pRTFField)
delete RTF data created by A3DMkpRTFInit Previously A3DMkpRTFDelete.
- Version
10.1
- Return values
A3D_ERROR –
A3D_SUCCESS –
- Returns
A3D_SUCCESS in case of success or an error code
-
A3DStatus A3DMkpRTFDelete(A3DVoid *pRTFData)
delete RTF data created by A3DMkpRTFInit
- Deprecated:
This function is deprecated. Please use the A3DMkpRTFFieldDelete to implement the same behaviour.
- Version
4.2
- Return values
A3D_ERROR –
A3D_SUCCESS –
- Returns
A3D_SUCCESS in case of success or an error code
-
A3DStatus A3DGlobalFontKeyGet(const A3DFontKeyData *pFontKeyData, A3DFontData *pFontData)
Retrieves font information (A3DFontData) from the A3DFontKeyData structure.
This function is useful when reading markup tessellation.
- Version
2.0
- Return values
A3D_INITIALIZE_NOT_CALLED –
A3D_INVALID_DATA_STRUCT_SIZE –
A3D_INVALID_DATA_STRUCT_NULL –
A3D_INVALID_ENTITY_NULL –
A3D_INVALID_ENTITY_TYPE –
A3D_MARKUP_CANNOT_ACCESS_FONT –
A3D_MARKUP_INVALID_FONTKEY –
A3D_SUCCESS –
- Returns
A3D_SUCCESS in case of success or an error code
-
A3DStatus A3DGlobalFontTextBoxGet(const A3DFontKeyData *psFontKeyData, A3DUTF8Char *pcText, A3DDouble *pdLength, A3DDouble *pdHeight)
Gets text bounding box according to the font.
- Version
5.2
- Return values
A3D_INITIALIZE_NOT_CALLED –
A3D_INVALID_ENTITY_NULL –
A3D_INVALID_ENTITY_TYPE –
A3D_MARKUP_CANNOT_ACCESS_FONT –
A3D_MARKUP_INVALID_FONTKEY –
A3D_SUCCESS –
- Returns
A3D_SUCCESS in case of success or an error code
-
A3DStatus A3DGlobalFontTextBoxAndScaleGet(const A3DFontKeyData *psFontKeyData, A3DUTF8Char *pcText, A3DDouble *pdLength, A3DDouble *pdHeight, A3DDouble *pdScale)
Gets text bounding box and scale according to the font.
- Version
7.2
- Return values
A3D_INITIALIZE_NOT_CALLED –
A3D_INVALID_ENTITY_NULL –
A3D_INVALID_ENTITY_TYPE –
A3D_MARKUP_CANNOT_ACCESS_FONT –
A3D_MARKUP_INVALID_FONTKEY –
A3D_SUCCESS –
- Returns
A3D_SUCCESS in case of success or an error code
-
A3DStatus A3DGlobalFontKeyCreate(const A3DFontData *pFontData, A3DFontKeyData *pFontKeyData)
Creates the A3DFontKeyData structure from the A3DFontData structure.
- Version
2.0
- Return values
A3D_INVALID_DATA_STRUCT_SIZE –
A3D_INVALID_DATA_STRUCT_NULL –
A3D_MARKUP_CANNOT_CREATE_FONTKEY –
A3D_MARKUP_INVALID_FONTKEY –
A3D_SUCCESS –
- Returns
A3D_SUCCESS in case of success or an error code
-
A3DStatus A3DGlobalFontTextTessellationGet(const A3DFontKeyData *psFontKeyData, const A3DUTF8Char *pcOneChar, A3DRiSet **ppset, A3DDouble *pdCharWidth)
Gets text tessellation as wireframe.
- Version
6.1
- Return values
A3D_INITIALIZE_NOT_CALLED –
A3D_INVALID_ENTITY_NULL –
A3D_INVALID_ENTITY_TYPE –
A3D_MARKUP_CANNOT_ACCESS_FONT –
A3D_MARKUP_INVALID_FONTKEY –
A3D_SUCCESS –
- Returns
A3D_SUCCESS in case of success or an error code