Subscribe to download
zam_showNames

Author: Phoenix of Zulu-Alpha
Author Website: http://zulu-alpha.co.za/
Repo: https://github.com/zulu-alpha/zam_shownames
Discussion page: https://forums.bistudio.com/topic/175176-zam-shownames/

Requirements: @cba_a3

Version: v3.5.0
Signed: Yes

Short description: An advanced and realistic name tag system designed to simulate real world recognition conditions.

Description:
Shows the names of nearby players when you hold down the key.
Factors such as time of day, fog, zoom, group membership, ranks, line of sight, optical zoom (factoring in simulated atmospheric distortion), thermals and voice are taken into account in order to make recognition as realistic as possible.
This has been separated out of the ZAM mods collection and is where you should get zam_showNames.

Features:

• Shows player names
  
• Displays ranks (optional)
  
• Name tag size corresponds linearly with distance
  
• Name tag fade's depending on distance and other factors (optional)
  
• Recognizes zoom (with any optics or no optics) and resizes name tags accordingly (optional)
  
• line of sight is considered by taking into account terrain and objects
  
• Passenger name tags are optimized
  
• Time of day taken into account to simulate the necessity for ambient lighting and\or NVGs to ID people
  
• Arma 3 enhanced fog is taken into consideration when determining ID range (optional)
  
• Smaller name tags are displayed for ruck sacks, named after it's last owner (optional)
  
• Fellow group member names are much bolder to aid in ID (optional)
  
• Knowledge system, allowing normally unknown men to be discovered (by approaching them) or already fully known (such as HVT\VIPs) (optional)
  
• Knowledge system also allows adding name tags to any object (such as crates and mission critical items)
  
• Players using TFAR or ACRE direct speak is indicated by a red name tag, with redness indicating how loud they are predicted to be (taking into account shout, whisper, etc) (optional)
  
• Performance demands of main loop and ACRE support configurable in userconfig (Arma scheduler permitting)
  
• Mission maker can force the enabling or disabling of optional features
  
• Key can be used as toggle or hold by setting in userconfig
  
• Detects if thermal is used and disables name tags (TI is bad at ID IRL).
  
• Show group names for other groups. Togglable with a key (default Ctrl-y). (optional)
  
• Show team names for current group (optional)

Installation:
Standard mod installation with @folder

Included Files:
zam_shownames.pbo

Usage:
Press t (or another key configured in Main Menu, Configure -> Controls -> Configure Addons -> ZAM -> showNames) to show the names of all players on your side and name tags of rucks used by players.
Note that the key options will appear in that menu only 5 seconds into the game.

Client side mod
Multiplayer and single player support


Media:

[postimg.org] [postimg.org] [postimg.org] [postimg.org] [postimg.org] [postimg.org] [postimg.org]
* These screenshots demonstrate only a fraction of the available features. The video shows almost all of them.

Credits & Thanks:LordHeart for assistance and early optimizations
KillZoneKid for his zoom detection code

License: Covered under APL-SA (http://www.bistudio.com/community/licenses/arma-public-license-share-alike)
Feel free to use and modify this code, on the proviso that you post back changes and improvements
so that everyone can benefit from them, and acknowledge the original authors in any derivative works.

Download: https://github.com/zulu-alpha/zam_shownames/releases/download/v3.4.5/zam_shownames_v3_4_5.zip


ChangeLog:

V3.5.0 - 28-01-2018
- Replaced .hpp settings file with CBA addon settings.
- Changed category name of keys in CBA settings and change default key to T

V3.4.5 - 8-12-2016:
- Fixed compatibility with A3 1.66 by removing empty var in for loop.

V3.4.4 - 1-12-2015:
- Fixed readme download link.

V3.4.3 - 1-12-2015:
- Minor cosmentic cleanup of code.

V3.4.2 - 26-04-2015:
- Fixed TFAR support by changing currentUnit to TFAR_currentUnit in fn_showNames_tfar_eh.sqf

V3.4.1 - 10-04-2015:
- Added support for CBAs new keybinding function.

V3.4.0 - 02-03-2015:
- Added shadows for much easier identification against bright backgrounds (should be as readable as AGMs).

V3.3.0 - 08-11-2014:
- Fixed support for TFAR and improved accuracy.
- Added support for @ACRE2. Also supports @st_acre_volume.
- Dramatically improved the smoothness of the name tags. Still has great difficulty in choppers though.

V3.2.1 - 15-08-2014:
- Added optional feature to show group names for other groups using toggle (ZAM_showNames_group_names).
- Added optional feature to show team names for current group (ZAM_showNames_group_teams).
- Added key to toggle group names (default Ctrl-y and configurable in cba key-binding menu). Default toggle mode is off.

V3.2 - 14-08-2014:
- Changed the way magnification is detected. Now all optics are supported, in all vehicles.
- Added detection of thermal imaging. Name tags are disabled when thermals are used (and fade is enabled).
- Changed ID ranges method. ID range is now only limited by the strength of optics (among other conditions).
- Tweaked fade handling
- Changed getFogViewDistance to be suitable for showNames. Should not be used anywhere else.
- getZoom function added.
- Fixed a few zero divisor errors.

V3.1.4 - 04-08-2014:
- Added CBA as a dependancy.
- Changed over to CBA keyhandler. You should now set your key in the game options.
- Attempted to fix _vd_player bug.

V3.1.3 - 23-07-2014:
- Added option to use key as toggle (set 'zam_showNames_conf_toggle = true' in the userconfig).
- Added singleplayer support
- Fixed zero divisor error with null check
- Fixed userconfig mess

V3.1.2 - 12-07-2014:
- Calibrated TFAR feature
- Fixed TS3 crash due to call extension on null object. Now tfar_eh more cautious.

V3.1.1 - 12-07-2014:
- Tweaked names heights when in vehicles and standing
- Added safety to make sure discoverable objects and normally seen objects don't clash

V3.1 - 09-07-2014:
- Reduced name tag sizes
- Feature added to allow mission makers to make units discoverable (knowledge feature) (optional)
- addDiscoverable function added
- Added support for miscellaneous objects through knowledge feature (name tag will display as ruck sack name tag)
- pressLoop function added - A helper thread to offload calculations from the onEachFrame stack that also allows finer performance controls
- Massive performance optimisation through the use of pressLoop function
- Added TFAR support
- Feature added to indicate relative volume of speaker (through redness of name tag) (Optional)
- tfar_eh function added
- tfar_vol function added
- Renamed to showNames