
################
A3DPDFTextDataEx
################

.. c:struct:: A3DPDFTextDataEx

   :c:struct:`~A3DPDFTextDataEx` structure. 
   
   Structure to specify a text line with extended fonts and languages. The font needs to be available in C:\Windows\Fonts directory on the machine where HOOPS Publish is run, or in the folder specified to A3DPDFInitializePDFLibAndResourceDirectory. Depending on the characters used in the string, the font must be chosen, as well as the according language. The value kA3DPDFLangAutoDetect should be used for m_eLanguage to avoid to specify language and encoding.
   
   
      Starting with version 2020 SP2, ``m_eLanguage`` only accepts ``kA3DPDFLangAutoDetect``\ .
   
   
   
      5.0 
   
   
   
   Index
   =====
   
   .. rubric:: Variables
   
   
   .. rst-class:: api-xref-list
   
   
   * :c:member:`~A3DPDFTextDataEx.m_pcTextString`
   * :c:member:`~A3DPDFTextDataEx.m_pcFontName`
   * :c:member:`~A3DPDFTextDataEx.m_pcEncodingName`
   * :c:member:`~A3DPDFTextDataEx.m_eLanguage`
   * :c:member:`~A3DPDFTextDataEx.m_iFontSize`
   * :c:member:`~A3DPDFTextDataEx.m_sColor`
   * :c:member:`~A3DPDFTextDataEx.m_bEmbedFontInPDF`
   
   



.. rst-class:: kind-group kind-variable

.. rubric:: Variables
   :class: kind-group-title


.. c:member:: A3DUTF8Char* A3DPDFTextDataEx.m_pcTextString

      .. rst-class:: sig-pretty-signature
      
         | :c:type:`~A3DUTF8Char`\ *
      
      Content of the text string. 
      
      It should be a single line text string (no carriage return supported). 
      



.. c:member:: A3DUTF8Char* A3DPDFTextDataEx.m_pcFontName

      .. rst-class:: sig-pretty-signature
      
         | :c:type:`~A3DUTF8Char`\ *
      
      Font name of the text. 
      



.. c:member:: A3DUTF8Char* A3DPDFTextDataEx.m_pcEncodingName

      .. rst-class:: sig-pretty-signature
      
         | :c:type:`~A3DUTF8Char`\ *
      
      Set null to keep default processing. 
      
      Supported encoding are "WinAnsiEncoding", "StandardEncoding", "MacRomanEncoding", "MacExpertEncoding", or "PDFDocEncoding" (see PDF specifications for more details). If NULL, the encoding is tentatively retrieved from m_eLanguage. 
      



.. c:member:: A3DPDFELanguage A3DPDFTextDataEx.m_eLanguage

      .. rst-class:: sig-pretty-signature
      
         | :c:enum:`~A3DPDFELanguage`
      
      Language used for the text string. 
      
      Must be ``kA3DPDFLangAutoDetect``\ . 
      



.. c:member:: A3DInt32 A3DPDFTextDataEx.m_iFontSize

      .. rst-class:: sig-pretty-signature
      
         | :c:type:`~A3DInt32`
      
      Size of the font. 
      



.. c:member:: A3DPDFRgbColorData A3DPDFTextDataEx.m_sColor

      .. rst-class:: sig-pretty-signature
      
         | :c:struct:`~A3DPDFRgbColorData`
      
      Color of the text. 
      



.. c:member:: A3DBool A3DPDFTextDataEx.m_bEmbedFontInPDF

      .. rst-class:: sig-pretty-signature
      
         | :c:type:`~A3DBool`
      
      If true, the font will be subsetted in the PDF document to only support the characters used in the page, no need to have the font on the computer for the one who will open the document. 
      
      For the best behaviour, m_bEmbedFontInPDF should always be set to true. 
      




