Blender containing integration of verse isn't too much different from normal Blender. User can work as usual, but he or she can share or easily exchange data with other users. Other users can run different clients (like Maya, 3DS Max, etc). Keep in mind, that client has to have some support of verse (usualy some plugin) to be able to share/exchange data with Blender. When no verse plugin exists for your favorite 3d app, then it isn't able to share data with your friends running cool Blender!
All testing builds contain Blender binary as well Verse server. Both Blender binary and Verse server print some debug information to stdout. When you work with large amounts of data, it is recommended to run both binaries with redirection of stdout:
./blender > /dev/null
./verse > /dev/null
Running Verse server is very simple. Just type in unix console:
./verseor, when you run Windows, then you have to type something like this:
verse.exeThere is no need to run verse server as root or admin user. Be aware of too restrictive firewalls and NAT. Verse server runs at port 4950.
Blender containing the integration with verse has a new item in the main File menu:
When you are running the verse server on your system (at localhost), you can select "Connect to localhost". When the verse server is running on some other connected computer, then you select "Connect ...". When you choose the latter, you will be prompted to enter the name of the machine running the verse server. You can specify machine with either the IP number or domain name:
After clicking "Connect to localhost" or pressing Ok button depending on the setup, Blender will try to connect to verse server. It can take several seconds (depends on your system ... Blender will be generating a secure key). If the connection isn't accepted (because the server isn't running, your network setting is wrong, etc.), then the following error messages will appear:
It is recommended to exit Blender and start Blender again, because Blender doesn't handle verse sessions perfectly yet.
When you are successfully connected to verse server you will see the corresponding item in Outliner. Outliner is useful and powerfull tool when you want to share data at verse server. Work with Outliner will be mentioned later.
It is possible to push mesh object to the verse server, when you are connected. The mesh object must be in edit mode. Enter edit mode and click on the Mesh item in the header of 3dview.
Select 'Push to Verse server'. Blender will send all neccessary data to the Verse server.
Note for coders: Blender will create both object and geometry node on the verse server. These nodes will be linked together with "VerseLink" called 'geometry'. Names of nodes will be created depending to blender names (ob->id.name and mesh->id.name). The geometry node will contain two layers (vertex layer and polygon layer). Blender will automaticaly subscribe to changes in both layers and changes in the transformation matrix of object node.
When an object is pushed to the verse server you will see two new items in Outliner (other verse clients connected to the verse server will see these nodes too).
You can see that there is one item called Cube and a second "subordinated" item called Cube too. First item represents the object node and it is equivalent to a Blender Object. The second "subordinated" item represents the geometry node and it is equivalent to Mesh data.
After some data has been pushed to the verse server, we can test that we are able to subscribe to "foreign" data. We will start a new blender session (at another computer or the same one ... it doesn't matter). Don't forget to connect to the right verse server ;-) . When we are connected to the verse server then we can see some well known items in Outliner.
We can click with RMB at object node (not the subordinated geometry node) and select 'Subscribe'. Blender will now create a new mesh object node and new mesh. The object will be in edit mode. We can then exit edit mode and try to move, rotate and/or scale the Object. The Object should be moved in the first blender session too :-) . This means that we are subcribed to all changes (again).
Most of the edit mesh tools work without problem now. I noticed some problems with Bevel and Merge. Other tools should work correctly. If you find any buggy tool, then feel free and send me email (address can be found on my personal page).
Note: Undo and redo work quite good, but keep in mind, that support of unod/redo experimental in edit mode.
Blender can receive in theory all changes from other verse clients. Changes are visualised in edit mode as well in object mode.
Note: If mesh object has subsurf modifier, then changes comming from other verse clients aren't visualised in object mode.
Outliner is used for the visualisation of all verse sessions (you can be connected at the same time to several verse servers), all object and geometry nodes and all avatars (avatar is a "special" verse object node representing verse client). When you click with RMB on the verse session, you can disconnect from the verse server. When you click with RMB on the verse object node, you can subscribe or unsubscribe from the verse node. When somebody is connected to verse server you will see the coresponding avatar node.
You can see an object node called blender_237:latitude on several screenshots. blender_237 is the name of the verse client and latitude is my hostname (exported system variable $HOSTNAME). If you want to see your hostname in outliner too, then you will have to execute the following command (UNIX only):
export HOSTNAME="name_of_my_computer"users using csh or tcsh have to type the following command:
setenv HOSTNAME "name_of_my_computer"You can also add these commands to your ~/.bashrc or ~/.tcshrc configuration files.
Renaming of verse nodes or the verse session doesn't work in the Outliner. You can rename object node in button window or in Transform Propertis panel in 3dview.
When user is connected at least to one verse server, then he or she can disconnect from all verse servers or can disconnect from each verse server separately.
You can also end the verse sersion in the Outliner clicking with RMB at session item.
Warning: reconnecting to same verse server will not work properly. It is recommended to restart Blender (and wait few seconds).
When the user is connected to several servers, the user will be prompted which session he or she would like to end.
You can submit bugs to Google Summer of Code bug tracker.