TMPFontAsset

Text Mesh Pro 폰트 엔진에서 사용하는 폰트인 'MonoBehaviour : TMPro.TMP_FontAsset'을 변경할 수 있는 플러그인입니다.

Text Mesh Pro 폰트 엔진은 게임 내에서 정적으로 사용하는 폰트는 sharedassets0.assets에 저장되어 있으며, 언어별 폰트 지원 등을 이유로 폰트 이름을 통해 폰트를 지정하는 동적으로의 사용은 resources.assets에 저장되어 있습니다.

옵션 설명

Font Family

선택된 asset의 폰트를 Font Family에서 지정한 폰트로 교체합니다.

이 플러그인에서 지원하는 폰트는 다음과 같습니다.

나눔바른고딕: KS1001에 기술된 2350개 글자.
NotoSansCJKkr_Regular SDF: KS1001에 기술된 2350개 글자.

폰트 수동으로 추가하기

폰트를 자동으로 생성하는 도구를 추가하기 전에 폰트를 수동으로 추가할 수 있는 임시 방법입니다.

공통준비물
유니티 엔진 2018.2.21f1 버전 Unity 다운로드 아카이브

이 필요합니다.

1. 유니티 엔진 2018.2.21f1으로 TextMesh Pro 폰트 에셋이 포함된 게임 빌드

새 프로젝트를 하나 만듧니다.

Create new unity project

폰트 파일과 글자 셋을 프로젝트로 임포트합니다.

Drag and drop font file and charactor set file from explorer to unity editor(Project->Assets tab).

Window-Package Manager를 엽니다.

'Window'->'Package Manager'. click it.

TextMesh Pro의 버전이 1.2.4인지 확인합니다. 아니라면 1.2.4버전을 선택한 후 Update to 버튼을 클릭합니다.

Check Version 1.2.4 of 'TextMesh Pro' asset

확인한 후 Package Manager 창을 닫고 Window->TextMesh Pro->Import TMP Essential Resources에 들어가서 Import Unity Package 창에서 Import를 클릭하여 본 프로젝트에 TextMesh Pro를 임포트한다.

(만약 폰트 에셋의 생성 또는 빌드에 실패할 경우 프로젝트에 있는 'TestMesh Pro' 폴더를 삭제하고 위의 작업을 다시한 후 Window->TextMesh Pro->Project Files GUID Remapping Tool에 들어가서 Scan Project Files->Save Modified Project Files를 클릭하고 작업중인 Scene과 Project를 저장한 후 유니티 에디터를 껐다가 다시 실행한다.)

Go 'Window->TextMesh Pro->Import TMP Essential Resources' and click 'Import' button at 'Import Unity Package' window. If creating font asset or build game failed, go 'Window->TextMesh Pro->Project Files GUID Remapping Tool' and click 'Scan Project Files->Save Modified Project Files' after remove 'TextMesh Pro' asset folder.

임포트를 완료한 후 'Window->TextMesh Pro->Font Asset Creator'로 간다.

'Font Creator' 창이 나타나면 'Font Source' 오른쪽의 동그란 원모양의 버튼을 클릭하고 위에서 추가한 폰트를 선택합니다.

In 'Font Creator' window, click circle button next to 'Font Source' and select previous imported font.

Atlas Resolution은 4096x4096을 선택합니다. 해상도가 높을 수록 글자 각각의 선명도는 증가하지만 용량이 기하급수적으로 증가합니다. KS1001에 기술된 2350자를 모두 포함하면서 볼만한 글자가 되려면 4096x4096 크기 정도는 되어야 할 것 같습니다. 해상도를 낮춰도 괜찮다면 원하는 해상도를 선택합니다.

select 4096 and 4096 in combobox next to Atlas Resolution

글자 셋은 'Characters from File'을 선택합니다. 그러면 바로 아래에 'Character File'을 선택하는 항목이 생깁니다.

select 'Characters from File' in combobox next to 'Character Set'

글자 셋 파일 옆의 동그란 원을 클릭한 후 위에서 추가한 글자 셋 파일을 선택합니다. 예제에서는 KS1001.txt 파일을 임포트했고 KS1001로 표시되는 것을 선택했습니다.

click circle button next to 'Charactor File' and select 'KS1001' previous imported.

'Get Kerning Pairs?'를 체크합니다. 위의 설정을 확인해보고 'Generate Font Atlas' 버튼을 클릭합니다. 여기서 버튼이 활성화 되지 않는다면 TextMesh Pro Essential Import를 했는지 확인합니다.
- Font Source: NanumGothic
- Atlas Resolution: 4096 x 4096
- Character Set: Characters from File
- Character File: KS1001
- Get Kerning Pairs?: checked

Check above settings. Then, click 'Generate Font Atlas' button

4096 x 4096 해상도로 폰트 에셋을 생성하면 시간이 매우 오래오래 걸립니다. 폰트 에셋 생성이 완료되면 오른쪽 검은 공간에 렌더링된 글자가 나타나고 'Save', 'Save As...' 버튼이 활성화됩니다. 'Save' 버튼을 클릭합니다. 폰트 에셋 이름은 기본으로 두고 저장을 합니다.

If creating font asset, rendered charactors will be show in left black space and 'Save' and 'Save As...' button is enabled.

저장을 했으면 'Font Creator' 창을 끕니다.

let font asset name as default, and click save button

'Hierarchy->Create->3D Object->TextMeshPro - Text'로 텍스트 개체를 만듧니다.

Click 'Create->3D Object->TextMeshPro - Text' in Hierarchy

만들어진 TextMeshPro 개체를 클릭한 후 Inspector 탭에서 'Text Mesh Pro (Script)->FONT SETTINGS->Font Asset' 오른쪽의 동그라미 버튼을 클릭하여 위에서 생성한 폰트를 클릭합니다. 그리고 'TEXT INPUT BOX'에 Sam과 ple 사이에 '테스트'를 입력하여 한글이 잘 나오는지 확인합니다.

Click 'TextMeshPro' object in 'Hierarchy' tab, click 'Inspector' tab, and click 'Text Mesh Pro (Script)->FONT SETTINGS->Font Asset' circle button. Select the font created above. input '테스트' between 'sam' and 'ple' in 'TEXT INPUT BOX'.

'File->Save Scene'으로 작업중인 Scene을 저장하고, 'File->Save Project'로 프로젝트를 저장하고, 'File->Build And Run'으로 프로젝트를 빌드합니다.

Click 'File->Save Scene', 'File->Save Project', and 'File->Build And Run'.

Project 폴더 내에서 Build 폴더를 생성하고 Build 폴더를 선택한 후 '폴더 선택' 버튼을 클릭합니다.

Click 'New Folder', rename 'New Folder' to 'Build', click 'Build' folder previous created, and click 'Select Folder' button.

게임 실행 창이 나타나면 'Play!' 버튼을 클릭합니다.

Click 'Play!' button in '(Project Name) Configuration' window

테스트란 글자가 잘 표시되는지 확인하고 게임을 종료합니다.

$Maybe show 'Sam테스트\nple text' in '(Project Name)' window$

2. 만든 게임에서 폰트 에셋 추출하여 TMPFontPlugin용으로 변환하기

Unity Assets Bundle Extractor 2.2 beta4 + hotfix1로 위에서 빌드한 게임의 sharedassets0.assets를 열고 위에서 생성한 폰트 이름으로 된 '(Font name) SDF Material', '(Font name) SDF Atlas', 'MonoBehaviour (Font name) SDF' 세 에셋을 'UABE json dump (cam be imported)' 형태로 'Export Dump'를 클릭합니다. (UABE의 자세한 사용법은 https://blog.nakwonelec.com/2018/03/26/unity-asset-bundle-extractor-%EC%82%AC%EC%9A%A9%EB%B2%95/ 을 참조)

Click '(Font name) SDF Material', '(Font name) SDF Atlas', and 'MonoBehaviour (Font name) SDF' and click 'Export Dump'. In 'Select a dump type' window, Select 'UABE json dump (can be imported)' and click OK

저장할 폴더는 위에서 빌드한 게임의 _Data 폴더(기본값)인 채로 그래도 '폴더 선택'을 클릭합니다.

Click 'Select Folder'

'Get script information'('Dump export') 창이 뜨면 '예'를 클릭합니다.

Click 'Yes' in 'Get script information'(or 'Dump export') window

'Managed' 폴더 안에 있는 모든 *.dll 파일을 선택한 후 '열기'를 클릭합니다.

Open Managed folder in (Game name)_Data folder and select all *.dll files. Click 'Open'

'(Game name)_Data' 폴더안에 위에서 'Export dump' 한 Material, Atlas, MonoBehaviour가 있는지 확인하고, MonoBehaviour를 텍스트 편집기로 엽니다.(Notepad++을 추천합니다. 메모장으로 편집하면 파일이 깨질 수 있습니다.)

Check 3 assets exported above. Open MonoBehaviour by notepad++

이 json 파일에서 '0 TMPro.FaceInfo m_fontInfo', '0 Array m_glyphInfoList', '0 TMPro.KerningTable m_kerningInfo', '0 float normalStyle', '0 float normalSpacingOffset', '0 float boldStyle', '0 float boldSpacing', '1 UInt8 italicStyle', '1 UInt8 tabSize' 항목을 남겨두고 나머지 항목은 지웁니다. 아래의 사진들은 필요없는 부분을 지우는 방법을 차근차근 보여주고 있습니다.
'0 TMPro.FaceInfo m_fontInfo' 키 안에 있는 '1 string Name' 키-값을 지웁니다.

Remove key-value '1 string Name' in '0 TMPro.FaceInfo m_fontInfo'

After removing key-value '1 string Name' in '0 TMPro.FaceInfo m_fontInfo'

최종 결과물을 확인하고 저장한 후 수정한 json파일의 이름을 '(Font name).Mono.json'으로 변경합니다. ('0 Array m_glyphInfoList'와 '0 TMPro.KerningTable m_kerningInfo'는 자식 항목이 많아서 +/- 기능으로 숨겼습니다.)

Result of modified *.Mono.json file

위에서 빌드한 게임의 'sharedassets0.assets.resS' 파일을 복사하여 '(Font name).assets.resS'와 같이 이름을 변경합니다. '(Font name).Mono.json' 파일과 '(Font name).assets.resS' 파일을 복사하여 'UnityL10nToolRelease/Plugins/FontPlugins/TMPFontAsset' 폴더에 붙여넣습니다. 그리고 같은 폴더 내에 다른 폰트의 *.Font.json 파일을 복사하여 '(Font name).Font.json'으로 이름을 변경합니다.

There are '(Font name).Mono.json' from modified MonoBehaviour json file, '(Font name).assets.resS' from 'sharedassets0.assets.resS', and '(Font name).Font.json' from other .Font.json file.

복사한 .Font.json 파일과 빌드한 게임_Data 폴더에 있는 Texture2D.json 파일을 엽니다. 'FontFamilyName' 은 UnityL10nTool에 표시되고자 하는 이름으로 설정하시고, 'm_Width', 'm_Height', 'm_CompleteImageSize'은 Texture2D.json 파일에 있는 동일한 항목의 값으로 수정하시면 됩니다.

Set 'FontFamilyName' as you wish. Modify 'm_Width', 'm_Height', 'm_CompleteImageSize' as same as Texture2D

모두 저장하고 UnityL10nTool에서 정상적으로 보이는지 확인합니다.

Check the font added. there is 'My Font'.

Font Asset TMPFontAsset ko KR - dmc31a42/UnityL10nTool GitHub Wiki

TMPFontAsset

옵션 설명

Font Family

폰트 수동으로 추가하기

1. 유니티 엔진 2018.2.21f1으로 TextMesh Pro 폰트 에셋이 포함된 게임 빌드

2. 만든 게임에서 폰트 에셋 추출하여 TMPFontPlugin용으로 변환하기

⚠️ GitHub.com Fallback ⚠️

Font Asset TMPFontAsset ko KR - dmc31a42/UnityL10nTool GitHub Wiki

TMPFontAsset

옵션 설명

Font Family

폰트 수동으로 추가하기

1. 유니티 엔진 2018.2.21f1으로 TextMesh Pro 폰트 에셋이 포함된 게임 빌드

2. 만든 게임에서 폰트 에셋 추출하여 TMPFontPlugin용으로 변환하기

⚠️ **GitHub.com Fallback** ⚠️

⚠️ GitHub.com Fallback ⚠️