097e2c7d0d9f60377c8a83ff96357e9b9d5d5e92
[feisty_meow.git] / huffware / documentation / docs_searchbert_v2.2.txt
1 Subject:
2 docs for searchbert v2.2 (part 1) [via fred huffhines]
3 From:
4 <09a0351a-9e36-414f-9322-adc731c3dddd@fred@gruntose.com>
5 Date:
6 04/29/2012 10:15 PM
7 To:
8 <fred@gruntose.com>
9
10 Object-Name: email notes to fred v1.6
11 Region: smokier (2562048, 2562304)
12 Local-Position: (175, 77, 84)
13
14 ===================================
15 info about the searchbert seeker robot
16 ===================================
17
18 ###
19 version 46.3
20 released October 8 2011
21 ###
22
23 author=fred huffhines (osgrid and second life avatar)
24 source=eepaw shop (see below)
25 price=*free*
26 ** note: if you paid for this, someone ripped you off.  please let fred huffhines in osgrid or second life know about this.
27 license = gpl [ http://www.gnu.org/licenses/gpl.html ] within metaverse (osgrid, opensims, second life, etc).
28
29     searchbert is a full-perm second life search engine that i created for the free scripts library (which used to be in the Solvo region of second life, but which no longer exists, sadly).
30
31     this device can find matches for nearby objects given just a part of the object's name.  after doings its scan, searchbert points out all the objects with multi-colored particle beams.
32
33     the objects can be scattered at different heights and distances, even fairly far away from searchbert, and still be accurately located.  avatars will also be found if their names match the search.  searchbert can point out up to 17 objects and avatars
34
35     if you 'Touch' searchbert, then it will tell you its usage info.  here is a more detailed version of the help information.
36     you can speak these commands near searchbert in open chat to give it some orders:
37
38     #find X
39         looks for any object nearby with "X" in its name.
40         try this one out: "#find primitive" (in osgrid) or  "#find object" (in second life)
41             that will find any items that have been left with their respective default names.
42         and this is a nice one: "#find e"
43             finds any object whose name contains the letter 'e'.  that's usually very many things.
44
45     #reset
46         clears any existing search matches that had been found.  the matches will eventually time-out and be forgotten anyhow, but this makes searchbert forget the search immediately.
47         if this command is used by the owner of searchbert while a search is active, it stops the search immediately, but doesn't clear any matches that may already have been found.  #reset can only be used this way by the owner, which avoids random peopl
48
49     #initialize
50         hard core brain-clearing command for the searchbert; makes it fully clear out and restart its scripts.
51
52     #skew
53         *bonus* a debugging command that makes searchbert point its arms in all directions.
54
55     #channel
56         allows the listening channel for searchbert to be changed.  example:
57             #channel 42
58         this makes searchbert listen for any commands on channel 42, a fact which should be reflected
59         in the menus and chat after this..
60
61 that's about it for the basics...  enjoy!
62 --fred huffhines
63
64 ====
65 more detailed and nutty searchbert notes...
66
67 * searchbert builds upon original scripts by christopher omega and ama omega, which gave me a starting point for the particle system and link message communication.  i have put quite a lot of time into the searchbert also, to make it zoom around in a spir
68
69
70 Subject:
71 docs for searchbert v2.2 (part 2) [via fred huffhines]
72 From:
73 <09a0351a-9e36-414f-9322-adc731c3dddd@fred@gruntose.com>
74 Date:
75 04/29/2012 10:15 PM
76 To:
77 <fred@gruntose.com>
78
79 Object-Name: email notes to fred v1.6
80 Region: smokier (2562048, 2562304)
81 Local-Position: (175, 77, 84)
82
83 * searchbert gets around second life's limitations on the number of search matches by moving around and looking at things from different angles.  it uses a spiral search pattern to traverse the area.  it has multiple "seeker rods" to find matches, and the
84
85 * you can rip all of searchbert's arms off and it won't feel a thing!  rez a searchbert on land where you have permissions, right-click on it and select "Edit".  when the editing dialog has popped up, hit this key combination: "ctrl-shift-L".  that is the
86
87 * release 46.3 fixes a bug in the menu system where only the owner would see the menu.  it also includes the newest doc file, which was omitted in the big 46.0 release.
88
89 * release 46.0 sees the arm reattachment code in a separate script.  we were doing fine with version 42.0 in open simulator, but second life had other ideas about how much space a script is allowed to occupy when compiled.  this forced us to separate out 
90
91 * as of searchbert 42.0, there is a notecard configuration system and a menuing system.  the options available in the notecards for configuration are broader than what is available in the menu interface, so far.
92 due to how scripts work, if you reset the scripts, then any items configured from the menu are forgotten and searchbert will fall back to whatever is specified in the notecard.
93
94 * the search range at which objects will be found can be re-configured inside searchbert's "searchbert config vX.Y" notecard.  there are two parts to this.  the max_spiral_radius variable is the maximum distance searchbert will travel away from its starti
95
96 * as of searchbert 32.5, searchbert is low lag:
97     old searchbert 31.3 crushed performance of densely packed and also second life's "openspace sims" before, eating up to 10% of the sim's recommended cpu.
98     that was then, version 32.5 is now (or was "now" when i wrote this screed); it uses about 10% of its former resources (so more like 1% or less of sim cpu) when it's active.  thanks very much to eren padar for measuring its performance with elf clan's 
99     also this version doesn't ask for link permissions unless it needs to put its arms back on.  thanks to hippyjim starbrook for that suggestion.
100
101 * searchbert is the freebie mascot for our store, Eclectic Electric Patterns and Widgets (eepaw).
102     check out the licensing notecard for our store locations.
103
104 * thanks for reading the extended notes.  you are a patient, patient person.  --fred huffhines.
105
106
107