KDC Product Documentations

User Tools

Site Tools

You are here: start » iapi » vacuumsystem
iapi:vacuumsystem

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
iapi:vacuumsystem [2017/04/04 10:35] – external edit 127.0.0.1iapi:vacuumsystem [2022/03/23 17:48] (current) – More typos kyrahabattoir
Line 1: Line 1:
-The KDC vacuum system simulate the chore activity of floor vacuuming and the progressive degradation of it's cleaning status.+The KDC vacuum system simulates the chore activity of floor vacuuming and the progressive degradation of its cleanlyness status.
 It is composed of the following objects. It is composed of the following objects.
 ====== The vacuum charger ====== ====== The vacuum charger ======
-{{:iapi:charger.png?nolink&100 |}}The vacuum charger is the home of your KDC vacuum cleaner, place it wherever you wish to store your vacuum cleaner when not in use. Clicking it will either create a fresh vacuum on the charger or will indicate you where the vacuum currently is (secondlife coordinates) and tell you who is currently using it, if anyone.+{{:iapi:charger.png?nolink&100 |}}The vacuum charger is the home of your KDC vacuum cleaner, place it wherever you wish to store your vacuum cleaner when not in use. Clicking it will either create a fresh vacuum on the charger or will indicate you where the vacuum is located (SecondLife coordinates) and tell you who is currently using it if anyone.
  
 If the vacuum cannot be found in the region, a new copy will automatically be rezzed on click and loaded with the last known data. If the vacuum cannot be found in the region, a new copy will automatically be rezzed on click and loaded with the last known data.
  
-**This is the object responsible of spawning the actual vaccum cleaner, you won't find the vacuum itself in the delivery box, simply rez the charger, place it and click it to get the vacuum cleaner spawned.**+**This is the object responsible for spawning the actual vacuum cleaner, you won't find the vacuum itself in the delivery box, simply rez the charger, place it and click it to get the vacuum cleaner spawned.**
  
 ====== The vacuum cleaner ====== ====== The vacuum cleaner ======
-{{:iapi:vac.png?nolink&100 |}}The vacuum cleaner can be picked up by clicking it and accepting the secondlife permission to attach. It can also be dropped on the spot by simply detaching it. To put it back on it's charger, simple detach it in close proximity of the charger.+{{:iapi:vac.png?nolink&100 |}}The vacuum cleaner can be picked up by clicking it and accepting the SecondLife permission to attach. It can also be dropped on the spot by simply detaching it. To put it back on its charger, simply detach it in close proximity to the charger.
  
-When worn, a menu can be open by clicking the vacuum cleaner, it will allow you to toggle it on and off, aswel as dropping it if your client doesn't allow you to simply detach it.+When worn, a menu can be open by clicking the vacuum cleaner, it will allow you to toggle it on and off, as well as dropping it if your client doesn't allow you to simply detach it.
  
-The vacuum will turn on as long as long as it has some battery charge and the dust reservoir isn't full.+The vacuum will turn on as long as it has some battery charge and the dust reservoir isn't full.
  
 You can check the battery capacity and dust reservoir on the bar indicators located on the handle. You can check the battery capacity and dust reservoir on the bar indicators located on the handle.
  
-If you wish to adjust it's "in hand" position, you can do so like with any SecondLife attachment. In order to save it, you have to briefly turn on the vacuum cleaner.+If you wish to adjust its "in hand" position, you can do so like with any SecondLife attachment. In order to save it, you have to briefly turn on the vacuum cleaner.
  
 ====== The trashcan ====== ====== The trashcan ======
-{{:iapi:trashcan.png?nolink&100 |}}This is where you can empty the KDC vacuum cleaner's dust reservoir. When wearing the vacuum cleaner, simply get into close proximity of the Trashcan and click it. After a brief animation the dust reservoir should be empty. +{{:iapi:trashcan.png?nolink&100 |}}This is where you can empty the KDC vacuum cleaner's dust reservoir. When wearing the vacuum cleaner, simply get into close proximity of the Trashcan and click it. After a brief animation, the dust reservoir should be empty. 
-This specific trashcan model is marked as "infinite" because it doesn't have a capacity of it's own. A future product may expand domestic waste treatment and offer a compatible trashcan which may include a limited capacity and the disposal of full trashbags.+This specific trashcan model is marked as "infinite" because it doesn't have a capacity of its own. A future product may expand domestic waste treatment and offer a compatible trashcan which may include a limited capacity and the disposal of full trash bags.
  
 ====== The VacuTrack ====== ====== The VacuTrack ======
-{{:iapi:vacutrack.png?nolink |}}The VacuTrack is the heart of the Vacuum System and allow you to define a vacuum-able area of floor. It also  allows to change various cleaning parameters.+{{:iapi:vacutrack.png?nolink |}}The VacuTrack is the heart of the Vacuum System and allows you to define a vacuum-able area of the floor. It also allows changing various cleaning parameters.
  
-The circular light can go through 3 distinct states:+The circular light can go through 3 distinct stages:
   * Fixed color: This means that the VacuTrack is currently idle.   * Fixed color: This means that the VacuTrack is currently idle.
   * Two LEDs spinning: Tracking mode, a vacuum is currently in use.   * Two LEDs spinning: Tracking mode, a vacuum is currently in use.
-  * Four LEDs spinning slowly: Decay mode, when the room cleanlyness is degreading.+  * Four LEDs spinning slowly: Decay mode, when the room cleanliness is degrading.
  
-Note: You can edit the vacuTrack and change the color of the casing and the ring to your liking, it will not affect its function.+Note: You can edit the VacuTrack and change the color of the casing and the ring to your liking, it will not affect its function.
  
 ===== Quick setup instructions ===== ===== Quick setup instructions =====
 {{ :iapi:marker.png?200|}} {{ :iapi:marker.png?200|}}
-  - Pick a nice spot on the wall of the room you wish to setup, not in the way but not hard to reach either. +  - Pick a nice spot on the wall of the room you wish to set up, And rez/install the VacuTrack there. 
-  - Left click the VacuTrack to bring up it's owner menu and select the option "Edit room". +  - Left-click the VacuTrack to bring up its owner menu and select the option "Edit room". 
-  - Once the VacuTrack is in room edit mode, click on the option "New Marker". This will create a room marker where you are standing. +  - Once the VacuTrack is in room edit mode, click on the option "New Marker". This will create a room marker where you are standing. (It looks like a red cylinder) 
-  - Edit your room marker to cover as much as possible of the room, from the floor to about eye level. You can change the size of the marker, it's position and height as long as it remains a perfect circle. Do not rotate it or change it's shape.+  - Edit your room marker to cover as much as possible of the room, from the floor to about avatar eye level. You can change the size of the marker, it's position, and height as long as it remains a perfect circle. Do not rotate it or change its shape.
   - Add more markers as needed to cover the entire room, no need to be extremely precise. (you can safely use shift drag to duplicate the markers)   - Add more markers as needed to cover the entire room, no need to be extremely precise. (you can safely use shift drag to duplicate the markers)
   - Once you are satisfied with the room coverage, click each marker, select the "Save" option and confirm. The markers will take a few seconds to disappear and the VacuTrack will confirm that a new area has been added.   - Once you are satisfied with the room coverage, click each marker, select the "Save" option and confirm. The markers will take a few seconds to disappear and the VacuTrack will confirm that a new area has been added.
   - Open the VacuTrack menu and click the option "Stop editing".   - Open the VacuTrack menu and click the option "Stop editing".
-  - The VacuTrack will output it's unique ID in local chat, write it down somewhere as you will need it later.+  - The VacuTrack will output its unique ID in local chat, write it down somewhere as you will need it later.
   - Congratulations, you just defined your first room! It now needs to be fully vacuumed to establish the base cleaning data.   - Congratulations, you just defined your first room! It now needs to be fully vacuumed to establish the base cleaning data.
  
Line 105: Line 105:
 </code> </code>
 ====== (optional)The floor surfaces ======= ====== (optional)The floor surfaces =======
-A floor surface script, configuration file and a set of textures are provided. Essentially this will allow you to make a set of prims to overlay over your vacuum able room and to make it automatically fade in and out based on the room dustyness.+A floor surface script, configuration file, and a set of textures are provided. This will allow you to make a set of prims to overlay over your vacuum-able room and to make it automatically fade in and out based on the room's dustiness.
  
 Its configuration is very similar to the monitoring panel: Its configuration is very similar to the monitoring panel:
Line 117: Line 117:
 //SHOW_UUID //SHOW_UUID
  
-//The minimum and maximum alpha values for the dust cover where 0 is fully transparent and 100 fully visible.+//The minimum and maximum alpha values for the dust cover where 0 is fully transparent and 100 is fully visible.
 MIN_ALPHA=0 MIN_ALPHA=0
 MAX_ALPHA=100 MAX_ALPHA=100
Line 126: Line 126:
 //This allows us to filter which labels we will be gathering, ignored if it is unset or set to "*" //This allows us to filter which labels we will be gathering, ignored if it is unset or set to "*"
 //Any label on the tracked objects that doesn't pass the filter will be ignored. //Any label on the tracked objects that doesn't pass the filter will be ignored.
-//Multiple entries, comma separated+//Multiple entries, comma-separated
 FILTER=* FILTER=*
  
Line 135: Line 135:
 You can use any prims and link them with the floor surface, as long as the floor surface remains the root prim, it will set the alpha value for all child prims. Several dust textures are provided for your convenience. You can use any prims and link them with the floor surface, as long as the floor surface remains the root prim, it will set the alpha value for all child prims. Several dust textures are provided for your convenience.
  
-NOTE: floor surfaces and monitoring panels also output IAPI compatible tracking data, so you can actually chain them in a bigger system, ex: multiple floor surfaces are traccked by a monitoring panel, which is tracked by a global monitoring panel that adds up the results for every rooms.+NOTE: floor surfaces and monitoring panels also output IAPI compatible tracking data, so you can actually chain them in a bigger system, ex: multiple floor surfaces are tracked by a monitoring panel, which is tracked by a global monitoring panel that adds up the results for every room.
  
 ====== How to use the vacuum cleaner ====== ====== How to use the vacuum cleaner ======
   * Rez the vacuum charger where you want it to be when unused.   * Rez the vacuum charger where you want it to be when unused.
   * Click the vacuum charger to make it create a fresh vacuum cleaner.   * Click the vacuum charger to make it create a fresh vacuum cleaner.
-  * In order to function, it's batteries need to contain some charge, to charge the vacuum cleaner, leave it on it's charger for a few minutes.+  * In order to function, its batteries need to contain some charge, to charge the vacuum cleaner, leave it on its charger for a few minutes.
   * Once the vacuum cleaner is turned on, simply walk around the room while making pauses every few steps.   * Once the vacuum cleaner is turned on, simply walk around the room while making pauses every few steps.
   * To fully vacuum the room you will have to pass the vacuum head on the surface of the entire room. Making stripes help.   * To fully vacuum the room you will have to pass the vacuum head on the surface of the entire room. Making stripes help.
iapi/vacuumsystem.1491302153.txt.gz · Last modified: 2017/04/04 10:35 by 127.0.0.1