Holographic SIM-Radar Ultra Edition - version 9.x
--------------------------
1.1.1 Quick-feature list
--------------------------
* Apple iPhone support! Supports instant Push-Alerts on your iPhone, iPod Touch or iPad! (Requires iOS 3.0 or newer on the Apple-devices)
*** With this feature you will instantly get alerts on your iPhone whenever someone enter or leaves your SIM.
* Optional email-notifications on who’s visiting your SIM.
* Unique, advanced Transfer'O'Tronic Technology, upgrade/replacement system! You never need to reconfigure new updated radars manually! (read section 1.5 for this cool technology)
* Automatic updates when future versions gets released!
* Full-SIM Scanner system!
* True real-time display updates of the complete SIM (WHen radar and antenna are within same SIM)
* Fully integrated with Land BodyGuard Security system! Issue Ban, Unsit, Eject, etc commands directly from the radar, and get total control over your secured areas from one easy convenient spot! (NEW in 7.0)
* Unlimited distance! Scan a complete SIM no matter where you are in the secondlife world.
* Surveillance several SIM's at once by using several rezzed radar-units. Virtually no limit on how many radar stations you can use at once. PERFECT for large-scale monitoring for sim-owners
* Advanced statistics-gathering with 60-day history-buffer (read section 1.4)
* Deploy your main-radar at your home-land, pick up the deployable sensor-antenna on top of radar-station and put it in the SIM you want to remotely watch from your home.
* Extreme capacity: Radar is capable of tracking up to 400 (four hundred) simultaneous avatars in the SIM where the sensor-antenna is put. (I've never seen more than about 60 avatars in one go, but hey - 400 is a good limit for the future i suppose)
* Uses advanced temp-on-rez technology together with new radar-scanning-technology! Radar station is 5 PRIMS. The radar rezzes it's parts dynamically when it's needed.
* Completely custom-work on all parts. Radar has been built from ground-on with custom scripting, custom sound-effects, custom textures and custom particle effects. It's been a real fun time building this one.
--------------------
Table of Contents
--------------------
1.2 Quick 5-minute Setup-Guide
1.3 Explanation of menu-system and it's features
1.3.1 The auto-update system
1.3.2 Selection of antennas, tinyDish & normalDish
1.3.3 Deployment of remote antennas
1.3.4 Cloaking of the antennas
1.3.5 Resizing the radar
1.3.6 Getting position data (pos on, pos off)
1.3.7 Inserting a custom texture as map-overlay
1.3.8 Muting sound-effects
1.3.9 Remote kill of the antenna
1.3.10 Operation of the optional Land BodyGuard Plugin (NEW in 7.0)
1.3.11 Hiding/Showing the 3D-radar-dome (NEW in 8.0)
1.3.12 Hiding/Showing of the radar roof (NEW in 8.4)
1.3.13 Configuring the type of map-overlay (NEW in 8.4)
1.3.14 Configuring the type of avatar-beacons (NEW in 8.4)
1.3.15 Hiding/Showing of hover-text on top of radar (NEW in 8.4)
1.4 The statistics module
1.4.1 Turning on/off avatar-notifications
1.4.2 Listing of history-statistics
1.4.3 Erasing of history-statistics
1.4.4 Erasing of the total-summary statistics (hover-text stats)
1.5 The transfer'O'tronic upgrade/replacement technology
1.5.1 What kind of data will transfer'O'tronic be able to transmit?
1.5.2 How to duplicate settings & data from old radar into new radar
1.6.1 The API data-channel system (NEW in 8.0)
1.8 Frequently Asked Questions
1.8.1 xxx failed re-sync attempts - how do i restart the radar if i get this message?
1.9.1 Credits and notes
------------------------------------
1.2 Quick 5-minute Setup-Guide
------------------------------------
* Rezz your radar station on-ground.
* Left-click on station to activate it
* The radar-station rezzes a deployable antenna on top of the station, you now got two choices:
1: Left-click on the antenna to scan the current SIM
2: Pick up the antenna, go to ANY SIM in the world and put it on ground
* Go back to your base where radar-station was rezzed and enjoy the peaking in peace. *GRIN*
* To deactivate it, issue the command /1killsensor to terminate the remote-antenna or just delete the station.
* The radar-station also gives easy-to-follow hover-text messages when you use it.
* When radar is open, you also get a dialog-menu when left-clicking on the radar-base. In that menu you can both resize the radar in different sizes, and you also got ability to terminate remotely deployed antennas.
* To mute sound, use command "/1mute".
-------------------------------------------------------------
1.3 Explanation of menu-system and it's features
-------------------------------------------------------------
The radar contains a easy to operate menu-driven interface. This section will explain all aspects of it.
-------------------------------------
1.3.1 The auto-update system
-------------------------------------
When you rez a new station on-ground, you will be asked if you want to check for new updates. Choose "CHECK" to initiate update-check, or choose "CANCEL" to ignore it.
The auto-update system will continue monitoring for updates silently, and will give you periodically information when needed.
-------------------------------------------------------------
1.3.2 Selection of antennas, tinyDish & normalDish
-------------------------------------------------------------
When you left-click on a un-opened radar-station, you will get a menu where you can choose between 2 different antennas. They are called "tinyDish" and "normalDish".
There is no technical difference between the 2 antennas. They work 100% similar to each-other. The only difference is that the "tinyDish" is only a 1-prim mini-antenna designed to be used on small parcels with limited prims available.
The "normalDish" is a more eye-candy designed antenna containing 7 prims, all with sound-effects and visual effects to fit the sci-fi style of the radar station itself.
----------------------------------------------
1.3.3 Deployment of remote antennas
----------------------------------------------
When you have chosen the preferred antenna and the radar has unpacked itself into normal size, you must deploy or activate the antenna.
If you want to surveillance the SIM you rezzed the radar in, you just have to left-click on the antenna to activate it (the antenna also informs about this with hover-text).
If you want to surveillance a remote SIM, you do the following procedure:
1: Right-click on antenna, and choose "take". The antenna will be put into your objects-folder.
2: Teleport to the remote SIM you want to surveillance.
3: Drag-and'drop the antenna down on ground in the SIM.
4: Go back to the SIM where radar station is located and enjoy.
Only ONE antenna per station. Delete the antenna from inventory after in-world deployment to avoid confusion. If you rez more than one antenna, you might get unpredictable results.
--------------------------------------
1.3.4 Cloaking of the antennas
--------------------------------------
When you deploy antennas in remote SIM's the antennas automatically cloaks itself and hides 100% so nobody can easy find it.
You can also force cloaking by issuing the command "/9cloak" in chat.
------------------------------
1.3.5 Resizing the radar
------------------------------
The radar is fully resize-able. When the radar is unpacked into full-size, you just left-click on the radar station and use the following menu-options for resizing:
"size normal"
"size big"
"size huge"
"size small"
"size mini"
Do some testing on your own to see what size that fits you best.
----------------------------------------------------
1.3.6 Getting position data (pos on, pos off)
----------------------------------------------------
The radar can also show exact position-data of all avatars found in SIM. This is by default turned OFF. To turn ON this feature, use the command "pos on" in menu. To turn it off again use "pos off".
There might be a delay for up to 45 seconds when switching it on/off.
--------------------------------------------------------
1.3.7 Inserting a custom texture as map-overlay
--------------------------------------------------------
You can make and put in a custom texture in the bottom of the radar, so you more easy can see where avatars are located in the SIM.
To make a map-texture, you have to take a snapshot of the SIM map in-world, or eventually extract it from www.secondlife.com website. I prefer extracting it from the webpages tough, since that generally contains higher detail.
1: When you have uploaded the texture into your inventory, right-click on the texture and choose "copy UUID".
2: Write in chat "/1texture
3: Woot, you got the custom texture automatically put at bottom.
----------------------------------
1.3.8 Muting sound-effects
----------------------------------
For all of you sound-sensitive people, the chat-command for muting the radar sound-effects are "/1mute".
---------------------------------------
1.3.9 Remote kill of the antenna
---------------------------------------
If you need to stop the radar for some reason, you can use the menu-command "killsensor". You can also use chat-command /1killsensor to kill it, but beware - if you got several radars within chat-range they all will respond to it if you use the chat-command. If you only need to shut down ONE of the radars, i suggest you use the menu-command instead by left-clicking on the radar.
note: You will not find the "killsensor" command inside the menu-system unless the radar is actually active and scanning. If the radar is already turned off, the killsensor menu-command will be hidden until you re-deploy another antenna.
-----------------------------------------------------------------
1.3.10 Operation of the optional Land BodyGuard Plugin
-----------------------------------------------------------------
This is a exiting and very powerful feature. If you own a copy of the "Land BodyGuard" security-system and got a lot of areas/sims that is protected with this security-system, you will be able to directly issue powerful administration-commands directly through the radar control system! The radar will automatically connect into ANY existing Land BodyGuard protector-networks you may have installed! You can issue commands like "unsit", "ban", "unban", "addpass" , "removepass" etc.
When the radar is running, you can just click on the avatar-beacons directly, and you will instantly get a menu-control system with all the available commands from the Land BodyGuard system. Then click on the desired command, and the command will be issued instantly.
You can choose between 2 operation modes. "ownerMode" and "groupMode". The "ownerMode" will only allow the owner of the radar to issue commands directly. If you want all persons in your land-group to be able to issue security-commands, just switch to the "groupMode" and off you go.
To configure "ownerMode" or "groupMode", just left-click on the radar to get up the main-menu, and then click on the "bodyGuard" button from the menu.
PS! The radar has a green dome surrounding the avatar-beacons. As long as this dome is surrounding the radar, you will not be able to click on the beacons directly unless you zoom into them real close. But fear not! There is a solution for that. You can now hide this green dome surrounding the beacons.
To hide or show the green holographic dome, just left-click on the radar to get up main-menu, then click on "...Dome" sub-menu button to get up the control-menu for the hiding/showing of this green dome.
Just hide the dome, and you will be able to fast and easy click on any of the beacons for direct control of your Land BodyGuard security system.
If you do not own a copy of the Land BodyGuard yet, i suggest you visit my shop and pick up a copy now to fully benefit this new powerful feature.
----------------------------------------------------------------
1.3.11 Hiding/Showing the 3D-radar-dome (NEW in 8.0)
----------------------------------------------------------------
You can hide and show the 3D radar-dome if you want to more easy be able to click on the avatar beacons. To show/hide the dome, click on radar base station and then choose "...Dome" sub-menu. In this sub-menu you will be able to turn it ON/OFF with the commands "showDome" and "hideDome".
-------------------------------------------------------------
1.3.12 Hiding/Showing of the radar roof (NEW in 8.4)
-------------------------------------------------------------
Sometimes the roof is not feasible to have active in the radar. Specially if you want to fully see the avatars that are very high in the sky (close to 768 meter height). To more easy see whats going on in high altitude, you can hide the roof completely.
To show/hide the roof, just click on the radar base station, then go into "...Dome" sub-menu and use the "hideRoof" and "showRoof" commands.
----------------------------------------------------------------
1.3.13 Configuring the type of map-overlay (NEW in 8.4)
----------------------------------------------------------------
In version 8.4a and newer version of the radar, the radar attempts to automatically download and display the SIM's map-overlay on the dome-floor. However, sometimes you might not want to show the map itself. The radar got a compass-display that can be used also, so you more easy can see what's going on where.
To configure the map-overlay, just click on the radar base station and then choose "...Prefs" sub-menu, then click on "...Map" sub-menu. There you will find the commands "Compass" and "RealMap". The "Compass" menu command will show a easy to read North, South, East, West overlay. The "RealMap" will attempt to automatically download the most recent made map-snapshot of the SIM.
--------------------------------------------------------------------
1.3.14 Configuring the type of avatar-beacons (NEW in 8.4)
--------------------------------------------------------------------
By default, the radar chooses what type of avatar-beacons that is best to be used in any situation. If you are using the radar to surveillance the current SIM you are in (the base station and antenna are in same SIM), the radar will show some cute little 1-prim avatar-shapes that will show you in real-time in witch direction avatars are walking and looking.
If you are surveil-lancing a remote-SIM (antenna deployed in a different sim than the station itself), it will show a simplified avatar-beacon with no direction indications. This simplified view-mode is due to the limited speed of communication system when running the radar in long-distance surveillance mode.
However, you can choose to override this at any time if you wish. You can manually choose what type of avatar-beacons you want to use by clicking on the radar base station, then choose "...Prefs" sub-menu, and then go into "...Beacons" sub-menu. (Note that in remove-mode, when antenna is in another SIM than the station itself, the radar will not be able to update in realtime the avatar's look-directions etc)
--------------------------------------------------------------------------
1.3.15 Hiding/Showing of hover-text on top of radar (NEW in 8.4)
--------------------------------------------------------------------------
You can choose to hide the statistics data on top of the radar if you want it to be secret. Just click on the radar base station, then click on the "...Prefs" sub-menu, and then choose "...Hovertext" sub-menu. Use "hoverON" to turn ON the hover-text (ON by default), or use "hoverOFF" to turn it permanently OFF.
Please note that if you hide the hover-text, you will not be able to see the warning-messages the radar will show when there is communication problems etc.
---------------------------------
1.4 The statistics module
---------------------------------
The SIM-radar contains a highly advanced statistics gathering module. This module will keep track of all important statistics such as how many visitors currently in sim, how many visitors that has been visiting, the average visitor time.
The statistics module also got a 60-day daily detail-history buffer. With this you can easy see exactly how much traffic you get every day.
The menu-interface for the statistics-module is activated by pushing the "...stats" button in radar main-menu.
-------------------------------------------------
1.4.1 Turning on/off avatar-notifications
-------------------------------------------------
To turn on avatar notification messages (arrival and departure), left-click on radar, choose "...stats" sub-menu, and click on "chat on". You will now receive notification whenever a avatar enters/exit the SIM.
To turn it off again, go into "...stats" menu and choose "chat off".
----------------------------------------
1.4.2 Listing of history-statistics
----------------------------------------
You cannot list history statistics until the radar has been operating for at least 24 hours. (logical enough)
To show the complete 60-day history buffer of daily traffic-statistics, you left-click on radar, choose "...stats" sub-menu and then click on "listStats". You will now get the list output in chat (private messages).
The 60-day buffer is a rolling-buffer. That means it will never "get full". When it reaches 60-day capacity, it will on each new day erase the stats older than 60 days to make space for new data.
-----------------------------------------
1.4.3 Erasing of history-statistics
-----------------------------------------
If you want to completely erase the 60-day rolling-buffer for some reason, you just left-click on radar, choose "...stats" sub-menu and click on "eraseStats". This will only erase the 60-day history, and will NOT erase the total traffic statistics in hover-text.
-------------------------------------------------------------------------
1.4.4 Erasing of the total-summary statistics (hover-text stats)
-------------------------------------------------------------------------
If you need to reset/erase the total summary-statistics that is contained within the hover-text of the radar, you left-click on radar, choose "...stats" sub-menu, and click on "reset". This will NOT erase the 60-day rolling buffer.
----------------------------------------------------------------------
1.5 The transfer'O'tronic upgrade/replacement technology
----------------------------------------------------------------------
This is really exiting and cool technology! With the Transfer'O'Tronic Technology, you can super-easy upgrade your radar with new versions, or replace malfunction radars without ever loosing any statistics data or settings! You don't even need to re-deploy active sensor-antennas!
This technology will ensure all customers to get super-fast replacements at the same time as no important data will be lost.
To read more about this technology, click this link.
--------------------------------------------------------------------------
1.5.1 What kind of data will transfer'O'tronic be able to transmit?
--------------------------------------------------------------------------
The transfer'O'tronic will be able to fully automatic transfer the following data into a new rezzed radar:
* All statistics stored in radar. Including 60-day history buffer.
* All important configuration/settings
* Automatically re-usage of already deployed sensor-antennas - no more need to re-deploy antennas at all!
It just can't get any easier to upgrade. :)
-------------------------------------------------------------------------------
1.5.2 How to duplicate settings & data from old radar into new radar
-------------------------------------------------------------------------------
This is the easy part. If you ever need to replace a existing radar, you just rez a new radar within 10 meters of it. Then you wait 5 seconds. A menu will automatically pop up with the following question "Compatible data-transfer objects is found. Would you like to transfer data from one of the found objects into this new rezzed object?".
Then you just click on "YES" to continue to next step in the auto-transfer system. You will now get a menu with 3 options:
"next": if several radars is found within 10 meters, use this button to select the correct radar to transfer data from. (a easy to see particle-beam will always show you what radar is selected)
"transmit": When you have selected the correct radar with the "next" button, click on "transmit" to complete the auto-transfer procedure.
"CANCEL": If you choose the data-transfer menu by accident, use this to abort the procedure.
Please wait until the radar tells you its finished transferring data before you delete the old radar. Just follow the easy on-screen messages and the procedure will be finished in just 2-3 clicks! :)
Its never been so easy to upgrade or replace your radar. Enjoy. :)
-------------------------------------------------------
1.6.1 The API data-channel system (NEW in 8.0)
-------------------------------------------------------
The API data-channel is a special communication-channel system that third-party developers can use to develop further plugins/add-on modules for the radar. By default, the API data-channel is turned OFF. To enable/disable it, click on radar base station, then click on "...Prefs" sub-menu, and then choose "...API Channel". Then you can use "API ON" and "API OFF" commands to turn it on/off.
When turned ON, the radar will whisper control-data on channels 717170 and 717171 that can be used in third-party add-ons/plugins you want to develop yourself, or use from a third-party developer.
----------------------------------------
1.8 Frequently Asked Questions
----------------------------------------
Please go to the Frequently asked Questions section on the web-site
-----------------------------
1.9.1 Credits and notes
-----------------------------
Scripting, concept-design, prim-design, sound, special-effects by Thomas Conover (C) 2005-2007
A special thanks to Skidz Tweak for making the cute little 1-prim avatar-shapes and textures for it. :)
A special thanks to Revolution Perenti for showing how to use automatic map downloads.