Search Unity

Where is full documentation for TMP ?

Discussion in 'UGUI & TextMesh Pro' started by Sergey_ksubox, Aug 3, 2020.

  1. Sergey_ksubox

    Sergey_ksubox

    Joined:
    Jul 29, 2015
    Posts:
    26
    Hello,

    I just start to check TextMesh Pro for my project, but can't find real documentation.
    https://docs.unity3d.com/Packages/com.unity.textmeshpro@3.0/manual/index.html#quick-start - this link has several old references to "User Guide" or so.
    And https://docs.unity3d.com/Packages/com.unity.textmeshpro@3.0/api/index.html - this link has just autogenerated doc without any reasonable description of members.
    I wonder did I miss something or this package is not intended to be documented ?
    And some strange things I found inside TMP:
    TextMeshPro is based on TMP_Text, TMP_Text is based on MaskableGraphic, but MaskableGraphic is not official part of Unity anymore (at least I didn't find reference pages in latest Unity releases, so I consider it's at least discontinued). How could it be so ? Isn't TextMesh Pro updated to latest Unity versions ?

    Need your help...
     
  2. Stephan_B

    Stephan_B

    Joined:
    Feb 26, 2017
    Posts:
    6,595
    The TextMeshPro documentation is lacking but currently being updated. The following documentation should still provide some useful information.

    The MaskableGraphic class is still an important part of the UI system. MaskableGraphic derives from Graphic. Not sure why it disappeared from the documentation but again it is core to the Canvas system.

    The latest releases of the TMP package are version 1.5.1 for Unity 2018.4, version 2.1.1 for Unity 2019.4 and version 3.0.1 for Unity 2020.x.

    Until the documentation is updated, you should be able to find lots of information on the forum here and in the many videos published over the years. In the event you are unable to find the information you seek, always feel free to post on the forum here.
     
  3. Sergey_ksubox

    Sergey_ksubox

    Joined:
    Jul 29, 2015
    Posts:
    26
    Thank you, Stephan.
    Will follow this way.
     
  4. CreepyGnome

    CreepyGnome

    Joined:
    Oct 10, 2009
    Posts:
    9
    @Stephan_B Any update on this? It has been 19 months since your last post saying it's "currently being updated" and "Until the documentation is updated".

    Out of curiosity is this on a Unity roadmap still or will it never truly be fully integrated into the Unity ecosystem?

    It would seem after 5 years since "TextMesh Pro Joined Unity" blog post there would have been official Unity Documentation for TMP created that would be in line with the other Unity officially documentation for edit and APIs.

    If I am mistaken and just unable to find it please let me know where on docs.unity3d.com I can find Editor usage and API docs.

    As of version 2022.2 I could not find anything in docs.unity3d.com other than the package information, the same old page about forum support, and the old external doc link. That external doc link currently feels woefully inadequate and out of date in many areas and doesn't have any API docs.

    EDIT:
    I just stumbled on the API docs in an unrelated search which was odd, so not easy to find by just searching docs docs.unity3d.com. As if I go there and search manual with "TMP_InputField" on any version including the latest 2022.2 I get "Your search for "TMP_InputField" did not result in any matches. Please try again with a wider search", that is bad.

    So found this indirectly searching for something else in Google. I should be able to find this in the main manual search in unity. As you can see the base URL is docs.unity3d.com.
    https://docs.unity3d.com/Packages/com.unity.textmeshpro@3.0/api/TMPro.TMP_InputField.html
    They are not great, but better than nothing they appear to be autogenerated with no explanation or example usage, at least on the few I've looked through so far.
     
    Last edited: Mar 6, 2022
  5. AcidArrow

    AcidArrow

    Joined:
    May 20, 2010
    Posts:
    11,791
    I mean this is the way Unity provides docs for packages these days:

    https://docs.unity3d.com/Packages/com.unity.textmeshpro@4.0/manual/index.html

    It seems there are enough docs here to me.

    If you want API stuff, you're better off looking at the package source.

    Unity is always notoriously slow with updating docs.
     
    Last edited: Mar 6, 2022
  6. bn-l

    bn-l

    Joined:
    Aug 27, 2022
    Posts:
    7
    Unity bought out textmesh pro in 2017. Six years ago. This old http link is still the best documentation there is for the main way of doing text in the engine: http://digitalnativestudios.com/textmeshpro/docs/.

    It's the old link from the original creators. Unity hasn't even moved it to their domain. This, again, is the main way of doing text officially in the unity engine.

    The TMP_Text class is a 500 line long monolith with no comments. How do people figure out the API on this beast? I want to know myself also.

    Ok I found this: https://docs.unity3d.com/Packages/com.unity.textmeshpro@4.0/api/TMPro.TMP_Text.html
    For version 4.0. I cannot find a way make it so the link goes to the latest version.

    There is also this: http://digitalnativestudios.com/textmeshpro/docs/ScriptReference. Which is outdated but commented.

    For anyone finding this thread from a google search: 1. congrats I have no idea how you did that. Google was completely useless for me on this. 2. I also feel your pain.
     
    Last edited: Feb 23, 2023
    a52 and Daniel-F like this.