MH+ Tool HUD light edition

========================================
MH+ Tool HUD Light Readme
========================================

Requirements: FireStorm viewer or Cool VL viewer


++++++++++++++++++++
Features include:
++++++++++++++++++++
*RadarChat Listener - using for ForeStorm / Cool VL Viewer RadarChat to HUD announce,
                      Shows nearby avator with distance, very low-lag.

*Simple Online Checker - tracking a online-status of multi avatars.
                         always announce with avatar on-line / off-line.

*Object Rezzer - Rez a any object at your foot.(incl 10*10 platform, multi-posing stand)

*Emoter - dialog button select emotion.

*Animation Control - Only the stop of all animation.

*Partner Hugger - built in couple animation (Kiss / Hug / FootKiss / SubHug / Subpet)

*Plugin Menu - Create and distribute your own plugins.


+++++++++++
Quick Start
+++++++++++
    - Unpack the box to your inventory
    - Attach the Tool-Object to your HUD part (default bottom right).
    - You can attach the Tool-Object to any HUD part.(recommend bottom or bottom left/right)
    - Turn on your SL viewer Radar options 'RadarChat announce for HUD' check-box.

    [for FireStrom users]
     * top menu --> world --> radar
     * click the option icon
     * turn on "Report Enter Alerts to Scripts"
     * turn on "Limit Results to Specific Radius" and set to limits 4096m

    [for Cool VL viewer users]
     * top menu --> world --> radar
     * click the options tab
     * check on "Announce key to HUD"
     * click the "Announce now" button


 [if you are men's avatar?]
    - edit the Tool-Object
    - open '!Partner Anims' notecard
    - change to 'WEARERGENDER=' values 'WEARERGENDER=1'
    - save notecard, and Tool-Object Re-attach



+++++++++++++++
MENU FUNCTIONS
+++++++++++++++
    [OnlineCK] : toggle avatar online check function on / off.

    [On_List] : lists now on-line avatars.

    [All_Reset] : reset to all scripts

    [Partner] :  Show Partner sub-menu

    [PlugIN] :   Show plugin sub-menu

    [Radar] : toggle Radar function on / off.

    [Stop Anime] : remove all animation

    [Emote] : Show emoter sub-menu

    [Rez Object] :  Show Rez Object sub-menu



+++++++++++++++
SUB-MENUS
+++++++++++++++
[Emote]
 'animation name' : selects animation
 (STOP) : Stops the current playing all emotion.
 (NECT) : show next page
 (PREV) : show previous page
 (BACK) : return to main menu


[Rez Object]
 'object-name' : selects rez object. All object that exists in inventory.
 (BACK) : return to main menu

  Rez a any object at your foot.
  built in objects : 10*10 platform


[Partner]
 'animation name' : selects animation
 (MAIN) : return to main menu

 After the animation is selected, target avatar selected.
 The distance to target avatar is 15m max.
  built in animations :
  (Kiss / Hug / FootKiss / SubHug / Subpet)


[PlugIN]
 '.script name' : selects plugin script name
 (BACK) : return to main menu

** Plug-in details depend on a plug-in each script. **



++++++++++++++++++++++++++++++++
How to use Simple Online Check
++++++++++++++++++++++++++++++++
   - Edit your 'MH+ Tool HUD' object
   - edit notecard( _online_check_avs )
      write the avatar UUID, names wanting on-line check
      (describe a UUID and the name each one line)
   - (auto loading) or click the [All_Reset] button
   - turn on  [OnlineCK] function



+++++++++++++++
NOTE
+++++++++++++++
[Radar]
* If the Radar-display is not normal by lag, please try this.
  [FireStorm]
     * top menu --> world --> radar
     * change the distance slider max to min. --> min to max.
  [Cool VL]
     * top menu --> world --> radar
     * click the "Announce now" button

* The indication of the radar is to up to 24 people.

* status update cycle = 2 second.

* When the avatar name is described in '_alert_avator' notecard.
  The color to HUD in red when avatar exists in same SIM.




+++++++++++++++++++
HOW TO MAKE PLUGIN
+++++++++++++++++++
Please refer to 'PLUGIN_All AV List'. This is a sample script.

**In the name of the script, 'PLUGIN_' should be a head.
**(for example) name of the script = 'PLUGIN_Abcdef' then displayed in the dialog as '.Abcdef'
**put a script same prims.
**The plug-in up to 11 in the maximum.


[API's]
//Call Main MENU
llMessageLinked(LINK_THIS,1001,"MENU",NULL_KEY);

//Get current Avatar List(radar)
llMessageLinked(LINK_THIS,4051,(string)link_num,NULL_KEY);
return : (string) distance, (string) avatar key  list (comma value separate string)


-----------------------------------------------------------------------------------
For inquiries please send a notecard to Mayumi Hirano.
(c)2009,2014 MH+

//////
これは以前の製品のアップデートでもありますが、リファインモデルという位置づけで必要機能を見直してスリム化や使いやすさを向上させたものです。すでに旧バージョンを購入された方には新パッケージを配布してありますのでおうけとりください。機能的には上記の図で示すとおり、既にSLビュワー側で実装されてしまっている機能については削除し、実装スクリプト数を減らしました。使い勝手が良くなった点ではエモーターが重複再生対応とすることで、より複雑な表情が簡単に作れるようになっています。無料のエモーターでも可能ですが１スクリプトのみで実装しているのでいつでも何処でも気にせずに使えるかと思います。あと、大きな変更点は既存のアバターオンラインチェック機能を標準で内包したことです。プラグイン版と全く同じではなく、この内蔵版ではアバターのUUIDを直書きする仕組みになっています(プラグイン版ではアバターの名前から自動的にUUIDを取得しています)大量のオンラインチェックには向きませんが、土地を持たずベーシックアカウントのみで活動されている場合などでは有用だと思います。（自分の土地を持っている人なら拙作の据置型オンラインチェックサーバーをお勧めします。手ぶらで便利ですよ～）細かなところの変更では以前のToolHUDではレーダーチャットの表示に単一プリムのテキスト表示を利用していた為、テキスト表示が途中で途切れて表示される事が多々ありましたが複合プリムで対処する事で最大２４名分を表示可能にしています。ただし、この人数制限は表示名の最大文字数=31文字が全てASCII文字(つまりは１バイト文字)である場合の最大を元に換算していますので、漢字やキリル文字など２バイト系で全桁とも使われた場合、表示が桁落ちしたり重なって表示されたりする可能性がありますのでご了承下さい。なお、自動アップデート機能が削除となりましたが、これはサポートしないという意思ではなく、少しでもスクリプトリソースを減らすという目的に沿った結果です。他の製品もこの方向で改善し、アップデートの際は新しい製品の一括配布(no transの物)か、中身のスクリプトの入れ替え(trans 可能な物)で行っていきます。