{{>toc}}

h1. Emoticons Options

For colored emoji support, check "this plugin":https://dev.adiirc.com/boards/4/topics/1355.

_Tip. [[Options Dialog|Options]] -> [[Messages Options|Messages]] -> [[Messages_Options#Pixel-spacing|Pixel spacing]] makes lines bigger, emoticons will also resize to be bigger._

h2. Use Emoticons

Enable or disable emoticons.

_Enabling emoticons only works on new messages after emoticons is enabled._

_All icons will be resized/scaled to fit inside the text line height, aspect ratio will be preserved._

h2. Use animated gifs

Enable or disable animated gifs support.

When the support is disabled, all gifs will stop animating and show the first frame as a static image.

h2. Case insensitive

If enabled, _text_ and _TEXT_ will both be replaced with the same icon, otherwise they could have different icons.

h2. Only replace whole words

If enabled, emoticons inside links and words will not be replaced.

h2. Stretch height to match line height

If enabled, emoticons will be stretched to match the real line height when [[Messages_Options#Pixel-spacing|Pixel Spacing]] is used.

h2. Use regex to match a pattern

If enabled, allows using a custom [[Scripting_Regex|Regular Expression]] to match the emoticons trigger.

h2. Regex

The [[Scripting_Regex|Regular Expression]] to use when *Use regex to match a pattern* is enabled.

_<emote> in the regex will be replaced with the pattern (trigger|trigger|trigger)._

h2. Adding emoticons through scripting

Use [[/setoption]] Emoticons Emoticon_<matchtext> <filename>.

_\ and = characters must be escaped with a \ character._

h2. Disable emoticons for channel/private windows

Channels or users windows excluded from showing emoticons.

_Per server settings can be added using network:#channel syntax._

h2. Always use emoticons for channel/private windows

Always show emoticons for some channels/users windows.

_Per server settings can be added using network:#channel syntax._

_These windows ignores/overrides the "Use Emoticons" option._

h2. Ignoring images from specific users

There is a *Emoticons* flag when adding a ignore in [[Options Dialog|Options]] -> [[Ignore Options|Ignore]].