Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/xiaobin83/Unity3D.EmojiText

EmojiText in Unity3D
https://github.com/xiaobin83/Unity3D.EmojiText

emoji ui unity3d

Last synced: 3 months ago
JSON representation

EmojiText in Unity3D

Host: GitHub
URL: https://github.com/xiaobin83/Unity3D.EmojiText
Owner: xiaobin83
License: mit
Created: 2017-04-22T13:25:00.000Z (over 7 years ago)
Default Branch: master
Last Pushed: 2018-01-13T21:46:57.000Z (almost 7 years ago)
Last Synced: 2024-07-14T04:35:07.709Z (4 months ago)
Topics: emoji, ui, unity3d
Language: C#
Size: 5.67 MB
Stars: 38
Watchers: 5
Forks: 11
Open Issues: 1
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome-unity-open-source-on-github - Unity3D.EmojiText - EmojiText in Unity3D (Text)

README

Untiy3D.EmojiText

![EmojiText](EmojiText.png)

## EmojiText

+ Extends from UnityEngine.UI.Text
+ Has the same performance if no EmojiConfig attached.
+ Layout handled by UnityEngine.UI.Text, only replaces UVs of generated text mesh. Thus you can use RichText to change size and color of text. (Emoji sprite wont change color. I disabled it. And you also need to set sizeFactor in EmojiConfig to 1)
+ No sub GameObject needed (actually need one for attaching CanvasRenderer). Use CanvasRenderer to render emoji mesh.
+ Support hyperlink click event with markdown link syntax. `[ClickMe](link_to_some_place)`
+ Support pre-defined text by markdown predefined text syntax. \`predefined text\`. And predefined text replacements delegates to `EmojiText.willInsertBackOnePredefinedString`.
+ Support escape character by input \uxxxxx directly.
+ Generate your own EmojiConfig with different emojis by using AltasBaker in Emoji -> Atlas Baker (you can use altas baker for other stuff, it reports all UVs and names to AtlasBakerWizard.OnAtlasBaked)
+ Works in edit mode.

## Quick setup
1. Copy Unity3D.EmojiText to your own Assets folder
2. Create GameObject under Canvas
3. Attach EmojiText component to the GameObject just created
4. Drag and drop asset `Unity3D.EmojiText/EmojiConfig` to Config field

![EmojiConfig](EmojiText_01.png)

5. Now you have emoji text with all TwitterEmoji characters.
6. If you want to handle hyperlink (markdown syntax), just add some Href On Clicked Event
7. Check `scn_demo` for more details.
8. Unity3D 5.3.x has bugs in InputField with emoji charaters, plz check `EmojiTouchScreenInputField.cs` for details (i just copy from UnityEngine.UI and did some fix).

## Create your own emoji characters
1. Create folder in your project. (like `Assets/MyEmoji`)
2. Copy your emoji sprites to this folder. The name of sprite should be the unicode of character. If you want to replace `A` with emoji sprite, just put a `41.png` to MyEmoji folder

![EmojiConfig_02_a](EmojiText_02_a.png)

3. Add EmojiText component to a GameObject without assigning EmojiConfig, you can see `Create Config` button in Inspector

![EmojiConfig_02_b](EmojiText_02_b.png)

4. Press `Create Config` button, you will get a EmojiConfig.asset in Assets folder

![EmojiConfig_02_c](EmojiText_02_c.png)

5. Select EmojiConfig.asset. You can see

![EmojiConfig_02_d](EmojiText_02_d.png)

6. Click `Create Atlas` and in the Atlas tool box, put path to `Asset/MyEmoji` in path to texture field, and then press `Atlas` button

![EmojiConfig_02](EmojiText_02.png)

7. Now you will atlas texture and correct emoji config with character `A`

![EmojiConfig_03](EmojiText_03.png)
![EmojiConfig_04](EmojiText_04.png)
![EmojiConfig_05](EmojiText_05.png)

8. If you want to add more emoji character to exist config, you can add multiple paths in atlas step

![EmojiConfig_06](EmojiText_06.png)

## License

TwitterEmoji comes from [Twemoji project](https://github.com/twitter/twemoji). It licensed under [CC-BY 4.0](https://creativecommons.org/licenses/by/4.0/). And I copied from [Unity-UI-emoji](https://github.com/mcraiha/Unity-UI-emoji).

Idea and some part of code come from [Unity-UI-emoji](https://github.com/mcraiha/Unity-UI-emoji), I changed it to fit my implementation.

## Misc

steam: 0x600d1dea