Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
products:m28:devel [2017/03/07 21:40] fk0724 [about developer kit] |
products:m28:devel [2017/03/29 11:01] (current) fk0724 [when you release your development] |
||
---|---|---|---|
Line 7: | Line 7: | ||
====== about developer kit ====== | ====== about developer kit ====== | ||
- | Thank you for purchase [[::projects:m28|M28]]. | + | Thank you for purchase [[::products:m28|M28]]. |
M28 does not drive by itself. However we have bundled a developer kit so that everyone who purchased can make themselves additional functions, and sell, distribute and introduce easily. | M28 does not drive by itself. However we have bundled a developer kit so that everyone who purchased can make themselves additional functions, and sell, distribute and introduce easily. | ||
Line 13: | Line 13: | ||
Do you want to light the headlight? Do you want to play the engine sound? You can do them yourself with the developer kit. Don't you want to drive M28? With the developer kit, you can make that wish much easier than developing everything. | Do you want to light the headlight? Do you want to play the engine sound? You can do them yourself with the developer kit. Don't you want to drive M28? With the developer kit, you can make that wish much easier than developing everything. | ||
- | All the purchaser of M28 have the right to sell or distribute their work which includes the kit. It's full-perm((script and poses are Copy / Trans))! | + | All the purchaser of M28 have the right to sell or distribute their work which includes the kit. It's transferable! |
==== configuration of the kit ==== | ==== configuration of the kit ==== | ||
Line 24: | Line 24: | ||
==== try our development sample out ==== | ==== try our development sample out ==== | ||
- | You find [[analogmatic|AnalogMatic for M28]] in the package of M28. This is our development in order to show you how VIAS works. After you install it, you can take your friend out with M28. We added 2 scripts and associate them with VIAS. | + | [[analogmatic|AnalogMatic for M28]] is our development in order to show you how VIAS works. After you install it, you can take your friend out with M28. We added 2 scripts and associate them with VIAS. |
**AnalogMatic for M28** … object\\ | **AnalogMatic for M28** … object\\ | ||
Line 31: | Line 31: | ||
├ m28drivervasepose.bvh … pose for driver\\ | ├ m28drivervasepose.bvh … pose for driver\\ | ||
├ m28passengerbasepose.bvh … pose for passenger\\ | ├ m28passengerbasepose.bvh … pose for passenger\\ | ||
- | └ vias10_for_m28.lsl … VIAS | + | └ vias10_for_m28.lsl … VIAS |
- | <WRAP center round important 60%> | + | See [[analogmatic|this page]] and install it. |
- | translating from [[devel_ja|Japanese]] | + | |
- | </WRAP> | + | ==== 3rd party showcase ==== |
+ | Please tell me when you release your development. We introduce your works here. | ||
+ | |||
+ | >> [[products/m28/3rd_party_showcase]] | ||
+ | ===== development information ===== | ||
+ | Make link both **developer kit** and **M28** by the same procedure as [[analogmatic|AnalogMatic]]. After that, add scripts, animation, sound, etc and send link message from the script according to the following API to control M28. | ||
+ | |||
+ | ==== about VIAS ==== | ||
+ | VIAS is the basic script that controls the car state. From now on, all our vehicles will be equipped with VIAS and will be able to control the cars with the same API system. | ||
+ | |||
+ | VIAS can | ||
+ | * control linkage motion of joints | ||
+ | * switch the lights ON / OFF | ||
+ | * run installing process >> see [[analogmatic#how to install|this video]] | ||
+ | * play / stop engine sound | ||
+ | |||
+ | By separating interfaces and physical engines and standardizing the specifications of car control scripts, the following advantages are generated for third-party developers. | ||
+ | |||
+ | * can divert engine script once developed | ||
+ | * can develop scripts without considering difficult parts such as linkage | ||
+ | * also creators who are not modeler can partly participate in development | ||
+ | |||
+ | Further, as the number of developers who adopt this mechanism increases, the following advantages are created for users. | ||
+ | |||
+ | * with one ride, they can try different operating methods and different ride comfort | ||
+ | * only necessary functions can be selected and used according to time or place | ||
+ | |||
+ | ==== VIAS API ==== | ||
+ | All transmission / reception is done with link message. | ||
+ | |||
+ | <code lsl2> | ||
+ | integer ApiVersion; | ||
+ | |||
+ | SendAPICommand(string command, integer value){ // transmission | ||
+ | llMessageLinked(LINK_ROOT, value, command, ""); | ||
+ | } | ||
+ | |||
+ | default{ | ||
+ | state_entry(){ | ||
+ | SendAPICommand("VERSION", 0); | ||
+ | } | ||
+ | |||
+ | link_message(integer sender, integer value, string response, key id){ // reception | ||
+ | if (response == "VIAS-M28"){ | ||
+ | ApiVersion = value; | ||
+ | } | ||
+ | else if (llGetSubString(response, 0, 3) == "VIAS"){ | ||
+ | llSay(0, "[ERROR] does not correspond to this model"); | ||
+ | } | ||
+ | } | ||
+ | } | ||
+ | </code> | ||
+ | |||
+ | |||
+ | ^ API ver. ^ command ^ value ^ 説明 ^ | ||
+ | | 1.0 | VERSION | --- | Query API version. In response to the inquiry, the following reply will be made.\\ response = "VIAS-M28" ... To [[sl>LINK_THIS]], assign a value obtained by multiplying value by 10 times and return it. In the case of ver.1.0, value = 10 is returned.| | ||
+ | | 1.0 | RESET | 0 | Discard variables related to vehicle body control held by VIAS and restore the following initial state.\\ LEFT = 0\\ SPEED = 0\\ GEAR = 0\\ PARKING = 1| | ||
+ | | ::: | ::: | 1 | Reboot VIAS. With this command, VIAS starts the installation work; moves and rotates each link prim to the prescribed position. After reboot, the following reply will be made.\\ response = "SEAT" ... To [[sl>LINK_SET]], returns the link number of SEAT. You may use this number as the passenger's sit target.\\ response = "INIT" ... To [[sl>LINK_SET]], returns the boolean whether succeed installing or not.| | ||
+ | | 1.0 | ENGINE | 0 | Stop engine sound. | | ||
+ | | ::: | ::: | 1 | Play engine sound.| | ||
+ | | 1.0 | TEXT | 0 | Text off.| | ||
+ | | ::: | ::: | 1 | Text on.| | ||
+ | | 1.0 | LEFT | -200 〜 200 | Turn handle left and rotate front wheels. ex) LEFT = -127 means turning right 12.7 degrees.| | ||
+ | | 1.0 | SPEED | -100 〜 100 | Changes "Speed : xx%" on the text and wheels rotate. When SPEED < 0, changes the Gear "R" on the text. VIAS does not have any physical parameters so car would not run with this command.| | ||
+ | | 1.0 | GEAR | 0 〜 4 | Changes "Gear : n" on the text and move shifter.| | ||
+ | | 1.0 | PARKING | 0 | Hides "P-Brake : ON" on the text.| | ||
+ | | ::: | ::: | 1 | Shows "P-Brake : ON" on the text.| | ||
+ | | 1.0 | LIGHT | 0 | head light = OFF / side lights = OFF | | ||
+ | | ::: | ::: | 1 | head light = ON / side lights = OFF | | ||
+ | | ::: | ::: | 2 | head light = OFF / side lights = ON | | ||
+ | | ::: | ::: | 3 | head light = ON / side lights = ON | | ||
+ | | 1.0 | BRAKE | 0 | Brake lamps OFF.| | ||
+ | | ::: | ::: | 1 | Brake lamps ON.| | ||
+ | | ::: | COVER | 0 | Hides engine cover.| | ||
+ | | ::: | ::: | 1 | Shows engine cover.| | ||
+ | |||
+ | ===== when you release your development ===== | ||
+ | ==== the name ==== | ||
+ | You need not use "anhelo" or "VIAS" in your development name. | ||
+ | ==== poses ==== | ||
+ | If you don't use the poses "m28driverbasepose.bvh" and "m28passengerbasepose.bvh", please kill them from the inventory. | ||
+ | ==== permission ==== | ||
+ | Customers have to make link between M28 and your development. So you should release it as modifyable. | ||
+ | ==== remarks on your AD ==== | ||
+ | Customers have to purchase M28 from anhelo when they use your development. So you should add that remarks on your AD. Our main store is [[http://maps.secondlife.com/secondlife/Kishijoten/185/45/720|here]]. Please add this LM in your package. | ||
+ | ==== after releasing ==== | ||
+ | Please tell me about | ||
+ | * SLURL of your shop | ||
+ | * about your development | ||
+ | * price | ||
+ | * whether DEMO available or not | ||
+ | * your avatar name and your shop name | ||
+ | We will publish about your development through | ||
+ | * in-world group notice | ||
+ | * subscriber kiosk system | ||
+ | * [[products/m28/3rd_party_showcase|our web site]] | ||
+ | * our main store | ||
+ | * SNS such as twitter, Facebook and so on | ||