Plugin:AVS - Revision history

Dart Raiden at 15:33, 13 June 2021

2021-06-13T15:33:48Z

← Older revision		Revision as of 18:33, 13 June 2021
Line 15:		Line 15:

	<!--T:6-->		<!--T:6-->
	Whenever an avatar changes, the plugin fires an event, passing the contacts handle in wParam and a data structure with the avatar information in lParam. Plugins which use the bitmap handles returned by <tvar\|MS_AV_GETAVATARBITMAP>MS_AV_GETAVATARBITMAP</> MUST subscribe to <tvar\|ME_AV_AVATARCHANGED>ME_AV_AVATARCHANGED</>, because the original bitmap handle may become invalid when the avatar changes.		Whenever an avatar changes, the plugin fires an event, passing the contacts handle in <tvar\|wParam>wParam</> and a data structure with the avatar information in <tvar\|lParam>lParam</>. Plugins which use the bitmap handles returned by <tvar\|MS_AV_GETAVATARBITMAP>MS_AV_GETAVATARBITMAP</> MUST subscribe to <tvar\|ME_AV_AVATARCHANGED>ME_AV_AVATARCHANGED</>, because the original bitmap handle may become invalid when the avatar changes.

	<!--T:7-->		<!--T:7-->

Dart Raiden at 15:22, 13 June 2021

2021-06-13T15:22:50Z

← Older revision		Revision as of 18:22, 13 June 2021
Line 12:		Line 12:

	<!--T:5-->		<!--T:5-->
	The service MS_AV_GETAVATARBITMAP returns a pointer to a cache entry, if an avatar is present for that contact. The service MAY return 0, in which case, there is no valid avatar yet. However, that doesn't mean there isn't ANY avatar, just that the avatar is not yet ready for use. When someone calls the service requesting an avatar, the plugin will try to get the avatar (if possible) and notify all subscribers via a hookable event as soon as the avatar is ready. If the avatar is already in the cache, it simply returns the cached entry.		The service <tvar\|MS_AV_GETAVATARBITMAP>MS_AV_GETAVATARBITMAP</> returns a pointer to a cache entry, if an avatar is present for that contact. The service MAY return 0, in which case, there is no valid avatar yet. However, that doesn't mean there isn't ANY avatar, just that the avatar is not yet ready for use. When someone calls the service requesting an avatar, the plugin will try to get the avatar (if possible) and notify all subscribers via a hookable event as soon as the avatar is ready. If the avatar is already in the cache, it simply returns the cached entry.

	<!--T:6-->		<!--T:6-->
	Whenever an avatar changes, the plugin fires an event, passing the contacts handle in wParam and a data structure with the avatar information in lParam. Plugins which use the bitmap handles returned by		Whenever an avatar changes, the plugin fires an event, passing the contacts handle in wParam and a data structure with the avatar information in lParam. Plugins which use the bitmap handles returned by <tvar\|MS_AV_GETAVATARBITMAP>MS_AV_GETAVATARBITMAP</> MUST subscribe to <tvar\|ME_AV_AVATARCHANGED>ME_AV_AVATARCHANGED</>, because the original bitmap handle may become invalid when the avatar changes.
	MS_AV_GETAVATARBITMAP MUST subscribe to ME_AV_AVATARCHANGED, because the original bitmap handle may become invalid when the avatar changes.

	<!--T:7-->		<!--T:7-->

Dart Raiden: Marked this version for translation

2021-06-13T15:15:05Z

Marked this version for translation

← Older revision		Revision as of 18:15, 13 June 2021
Line 9:		Line 9:
	This is a service plugin, which means, it doesn't provide anything useful on its own except for a few service(s) and event(s) which can be used by other plugins. It loads avatars on demand and maintains an internal cache of avatar bitmap handles. It also handles avatar changes transparently and can notify event subscribers about avatar changes.		This is a service plugin, which means, it doesn't provide anything useful on its own except for a few service(s) and event(s) which can be used by other plugins. It loads avatars on demand and maintains an internal cache of avatar bitmap handles. It also handles avatar changes transparently and can notify event subscribers about avatar changes.

	== How it works ==		== How it works == <!--T:4-->

			<!--T:5-->
	The service MS_AV_GETAVATARBITMAP returns a pointer to a cache entry, if an avatar is present for that contact. The service MAY return 0, in which case, there is no valid avatar yet. However, that doesn't mean there isn't ANY avatar, just that the avatar is not yet ready for use. When someone calls the service requesting an avatar, the plugin will try to get the avatar (if possible) and notify all subscribers via a hookable event as soon as the avatar is ready. If the avatar is already in the cache, it simply returns the cached entry.		The service MS_AV_GETAVATARBITMAP returns a pointer to a cache entry, if an avatar is present for that contact. The service MAY return 0, in which case, there is no valid avatar yet. However, that doesn't mean there isn't ANY avatar, just that the avatar is not yet ready for use. When someone calls the service requesting an avatar, the plugin will try to get the avatar (if possible) and notify all subscribers via a hookable event as soon as the avatar is ready. If the avatar is already in the cache, it simply returns the cached entry.

			<!--T:6-->
	Whenever an avatar changes, the plugin fires an event, passing the contacts handle in wParam and a data structure with the avatar information in lParam. Plugins which use the bitmap handles returned by		Whenever an avatar changes, the plugin fires an event, passing the contacts handle in wParam and a data structure with the avatar information in lParam. Plugins which use the bitmap handles returned by
	MS_AV_GETAVATARBITMAP MUST subscribe to ME_AV_AVATARCHANGED, because the original bitmap handle may become invalid when the avatar changes.		MS_AV_GETAVATARBITMAP MUST subscribe to ME_AV_AVATARCHANGED, because the original bitmap handle may become invalid when the avatar changes.

			<!--T:7-->
	Fetching avatars is done in a separate thread with reasonable delays to avoid getting into troubles with flood protection(s). Avatars are cached "in memory".		Fetching avatars is done in a separate thread with reasonable delays to avoid getting into troubles with flood protection(s). Avatars are cached "in memory".

	== How to use it ==		== How to use it == <!--T:8-->
	</translate>		</translate>
	<pre>#include "m_avatars.h"		<pre>#include "m_avatars.h"

Dart Raiden at 15:14, 13 June 2021

2021-06-13T15:14:59Z

← Older revision		Revision as of 18:14, 13 June 2021
Line 8:		Line 8:
	<!--T:3-->		<!--T:3-->
	This is a service plugin, which means, it doesn't provide anything useful on its own except for a few service(s) and event(s) which can be used by other plugins. It loads avatars on demand and maintains an internal cache of avatar bitmap handles. It also handles avatar changes transparently and can notify event subscribers about avatar changes.		This is a service plugin, which means, it doesn't provide anything useful on its own except for a few service(s) and event(s) which can be used by other plugins. It loads avatars on demand and maintains an internal cache of avatar bitmap handles. It also handles avatar changes transparently and can notify event subscribers about avatar changes.
	~~</translate>~~

	== How it works ==		== How it works ==
Line 20:		Line 19:

	== How to use it ==		== How to use it ==
			</translate>
	<pre>#include "m_avatars.h"		<pre>#include "m_avatars.h"

Dart Raiden: Marked this version for translation

2018-04-07T18:00:42Z

Marked this version for translation

← Older revision		Revision as of 21:00, 7 April 2018
Line 4:		Line 4:
	Loads and manages contact pictures for other plugins.		Loads and manages contact pictures for other plugins.

	== About ==		== About == <!--T:2-->

			<!--T:3-->
	This is a service plugin, which means, it doesn't provide anything useful on its own except for a few service(s) and event(s) which can be used by other plugins. It loads avatars on demand and maintains an internal cache of avatar bitmap handles. It also handles avatar changes transparently and can notify event subscribers about avatar changes.		This is a service plugin, which means, it doesn't provide anything useful on its own except for a few service(s) and event(s) which can be used by other plugins. It loads avatars on demand and maintains an internal cache of avatar bitmap handles. It also handles avatar changes transparently and can notify event subscribers about avatar changes.
	</translate>		</translate>

Goraf: split translation units

2018-04-07T12:58:11Z

split translation units

← Older revision		Revision as of 15:58, 7 April 2018
Line 3:		Line 3:
	<!--T:1-->		<!--T:1-->
	Loads and manages contact pictures for other plugins.		Loads and manages contact pictures for other plugins.
	~~</translate>~~

	~~<translate>~~		== About ==
	== ~~What it does?~~ ==
	This is a service plugin, which means, it doesn't provide anything useful on its own except for a few service(s) and event(s) which can be used by other plugins. It loads avatars on demand and maintains an internal cache of avatar bitmap handles. It also handles avatar changes transparently and can notify event subscribers about avatar changes.		This is a service plugin, which means, it doesn't provide anything useful on its own except for a few service(s) and event(s) which can be used by other plugins. It loads avatars on demand and maintains an internal cache of avatar bitmap handles. It also handles avatar changes transparently and can notify event subscribers about avatar changes.
	</translate>		</translate>

	~~<translate>~~		== How it works ==
	== How it works?==
	The service MS_AV_GETAVATARBITMAP returns a pointer to a cache entry, if an avatar is present for that contact. The service MAY return 0, in which case, there is no valid avatar yet. However, that doesn't mean there isn't ANY avatar, just that the avatar is not yet ready for use. When someone calls the service requesting an avatar, the plugin will try to get the avatar (if possible) and notify all subscribers via a hookable event as soon as the avatar is ready. If the avatar is already in the cache, it simply returns the cached entry.		The service MS_AV_GETAVATARBITMAP returns a pointer to a cache entry, if an avatar is present for that contact. The service MAY return 0, in which case, there is no valid avatar yet. However, that doesn't mean there isn't ANY avatar, just that the avatar is not yet ready for use. When someone calls the service requesting an avatar, the plugin will try to get the avatar (if possible) and notify all subscribers via a hookable event as soon as the avatar is ready. If the avatar is already in the cache, it simply returns the cached entry.

Line 18:		Line 17:

	Fetching avatars is done in a separate thread with reasonable delays to avoid getting into troubles with flood protection(s). Avatars are cached "in memory".		Fetching avatars is done in a separate thread with reasonable delays to avoid getting into troubles with flood protection(s). Avatars are cached "in memory".
	~~</translate>~~

	~~<translate>~~		== How to use it ==
	== How to use it ~~(for developers only)~~ ==
	~~</translate>~~
	<pre>#include "m_avatars.h"		<pre>#include "m_avatars.h"

Dart Raiden at 00:50, 7 April 2018

2018-04-07T00:50:36Z

← Older revision		Revision as of 03:50, 7 April 2018
Line 22:		Line 22:
	<translate>		<translate>
	== How to use it (for developers only) ==		== How to use it (for developers only) ==
			</translate>
	<pre>#include "m_avatars.h"		<pre>#include "m_avatars.h"

Line 58:		Line 59:
	...		...
	}</pre>		}</pre>
	~~</translate>~~

	{{PluginGroups}}		{{PluginGroups}}

Dart Raiden: add info from docs

2018-04-07T00:48:20Z

add info from docs

@@ Line 3: / Line 3: @@
 <!--T:1-->
 Loads and manages contact pictures for other plugins.
 </translate>
 {{PluginGroups}}

Dart Raiden at 00:04, 25 December 2017

2017-12-25T00:04:43Z

← Older revision		Revision as of 03:04, 25 December 2017
Line 2:		Line 2:
	<translate>		<translate>
	<!--T:1-->		<!--T:1-->
	~~Load~~ and ~~manage~~ contact pictures for other plugins.		Loads and manages contact pictures for other plugins.
	</translate>		</translate>

	{{PluginGroups}}		{{PluginGroups}}

Goraf: Marked this version for translation

2017-12-20T10:48:04Z

Marked this version for translation

← Older revision		Revision as of 13:48, 20 December 2017
Line 1:		Line 1:
	<languages/>{{PluginCard}}		<languages/>{{PluginCard}}
	<translate>		<translate>
			<!--T:1-->
	Load and manage contact pictures for other plugins.		Load and manage contact pictures for other plugins.
	</translate>		</translate>

	{{PluginGroups}}		{{PluginGroups}}