XYZ vrml editor: description of the interface
Menù
File
new
open
file open form
save
file save form
save in blaxxun frameset
blaxxun frameset form
fields and
buttons
save a screenshot
Modify
Background
Background form
fields and buttons
fog
fog form
tools
view selected node in the nodes tree
edit with vrmlpad
add grid
remove grid
add random mountain landscape
remove random mountain landscape
add flat landscape with texture
remove flat landscape with texture
your objects
add an object to the menù
add an object to the world
remove an object from the menù
Help
frames
the orange frames
left orange frame
fields and buttons
animation button
animation
form
top orange frame
the violet frame
buttons
the blue frame
fields and buttons
the dark red frame
the gray frame
new: this will open a new empty vrml world inside the editor.
open:this will load a form to open a vrml file (.wrl) from your disk.The file open form: there are listed disks, folders,and vrml files (.wrl) on your computer.
Selecting a file will write its path in the text field, clicking open will open the file inside the editor.
clicking ok will unload the formsave: This will load a form to save the actual state of the vrml file you are editing.
The file save form: there are listed disks, folders,and vrml files (.wrl) on your computer.
You must select a folder where the file will be saved, then write the file name(without ".wrl")
and click on save to save it on disk as a vrml file.
clicking ok will unload the form.save in blaxxun frameset : this will load a form to save the actual state of a vrml file in multiuser mode.
the field title : the name of your world displayed in the chat's list
the field url : the url where all the files will be on internet. must end with / (example : "http://www.dhyan.it/virtual/")
the field message : this message will be displayed in the chat when someone open it.
the field more parameters: The blaxxun frameset uses many paramaters to control the multiuser virtual world and the chat ( for example you can change colors or the default avatar ecc..),each parameter and its value must be written in a single line, a complete list of the avilable paramenters is here
The button parameters help: opens the list of all parameters with description
The files field : you must select a folder on disk where all the files wil be saved, this shoul be the same directory where all the resources (textures ecc..) are. in the right is written a list of all the files that will be saved.
The ok button : will save all the files in the selected directory.save a screenshot: :this will change the main editor window, the 3d screen will become bigger and a field will appear with the file name. To save the screenshot write the file name into the field and click on save. the image will be saved as bitmap. the back to normal window button will make the window again in its normal interface.
Background: this will load a form to modify the background of the world
The background form: the background is like a big cube all around anithing in the virtual world, each internal face of the cube can have an image, if there are no images the background is like a sphere of color or colors around anything in the virtual world. for more informations look at the background vrml node , mfcolor field
the field fronturl: you can select an image that will be displayed in the virtual world in the front internal face of the big cube around everything , or write [] for no image
the field backurl: you can select an image that will be displayed in the virtual world in the back internal face of the big cube around everything , or write [] for no image
the field lefturl: you can select an image that will be displayed in the virtual world in the left internal face of the big cube around everything , or write [] for no image
the field righturl: you can select an image that will be displayed in the virtual world in the right internal face of the big cube around everything , or write [] for no image
the field topurl: you can select an image that will be displayed in the virtual world in the top internal face of the big cube around everything , or write [] for no image
the field bottomurl: you can select an image that will be displayed in the virtual world in the bottom internal face of the big cube around everything , or write [] for no image
The skyColor field specifies the colour of the sky at various angles on the sky sphere. The first value of the skyColor field specifies the colour of the sky at 0.0 radians representing the zenith (i.e., straight up from the viewer).
The skyAngle field specifies the angles from the zenith in which concentric circles of colour appear. The zenith of the sphere is implicitly defined to be 0.0 radians, the natural horizon is at/2 radians, and the nadir (i.e., straight down from the viewer) is at
The groundColor field specifies the colour of the ground at the various angles on the ground partial sphere. The first value of the groundColor field specifies the colour of the ground at 0.0 radians representing the nadir (i.e., straight down from the user)
The groundAngle field specifies the angles from the nadir that the concentric circles of colour appear. The nadir of the sphere is implicitly defined at 0.0 radians. groundAngle is restricted to non-decreasing values in the range [0.0,
the test button will test the background specified in the fields in the vrml world (sometimes images doesn't load immediatly)
the restore button will restore the world as it was before the backround was modified.
the cancel button will restore the world as it was before the backround was modified and unload the background form
the ok button will apply the changes you made to the backround.Fog: this will load the fog form to change fog color and visibilty .
The fog form: in the fog form you can select a color of the fog writing it or selecting it, to select it click the button and click on the color form when you like the color., in the visibilty range field you can write a number between 0 and infinite , this number specifies the distance of the visible objects in the fog, if the number is 0 there won't be any fog.
The test button : will test the fog in the world, The cancel button will restore the fog as it was before the changes you made and unload the form, the ok button will apply the changes you made to the fog.
for more informations : the fog node , sfcolor field
View selected node in the nodes tree: This will open a form with a text showing the structure of the nodes inside the vrml world, each node has a type and a name , shapes have also the geometry field, the node actually selected will be written with (Selected). these nodes aren't all the nodes inside the world but only the nodes that the editor is analyzing.
Edit with vrml pad, this will load a small form where you can click 2 buttons:
Edit vrml source in vrml pad: will save the actual state of the 3d world in a temporary file , the temporary file will be opened in vrml pad.
Load document from vrml pad: will load the actual state of the vrml edited in vrml pad inside the XYZ editor.Add grid: this will add a grid to the world, so you can see easily the 0 0 0 point and the units.
Remove grid: will remove the grid you added to the world, this will work only if the world has been saved or applied after you added the grid.
Add random mountain landscape : this will add a random mountain landscape that changes everytime the world is loaded, and a viewpoint in 0 2 0( the center of the landscape)
Remove random mountain landscape: will remove the random mountain landscape you added to the world, this will work only if the world has been saved or applied after you added the random mountain landscape
Add flat landscape with texture: this will add a flat landscape with texture to the world, a form will open where you must select an image for the texture,images can be jpg or gif, you can see a preview of the image, then click ok and the landscape with the image will be added to the world.
Also a viewpoint will be added to the world in the center of the landscape.Remove flat landscape with texture : will remove the flat landscape with texture you added to the world, this will work only if the world has been saved or applied after you added the flat landscape with texture
Add an object to the menù: if you use often a vrml object into your worlds you can add this object to the menù to use it easily, A form will open with all the disks , folders and vrml files (.wrl) in your computer, you must select a file and click on open, then click ok.
Add an object to the world: here there is a list of your objects, write a position for the object in the position red field and click on the object name in the menù, this will add the object to the world.
Remove an object to the menù, you can have up to 10 objects in the menù, if you don't need anymore an object you can remove it to replace it with another one, to remove the object click on it in the menù.
Help editor: will open this page
Help vrml will open the help for the vrml language
Help nodes will open a list of all the vrml nodes with description for each node
Help fields will open a list of all the vrml field types with description for each typeHelp index will open a page with general informations about the editor and the index of help contents
Left orange frame:The left orange frames has 3 states:empty , with the fields of the selected shape that is being modified , ready for animation.
the frist state: empty is when no shape is selected and being modified , then when you select a shape and click on modify selected all the fields about this shape are written in the frame so that you can modify it, this is the secon state , the third state is when you click on make animable button and the shape is ready for the animation. in this state there is only one button: animation that will open the animation form.
these are the fields and buttons of the orange left frame, they are all visible in the second state except animation that will be visible in the third statetranslation: the position of the shape in the 3d world for more info look the transform node , sfvec3f field
center: the center of the shape in the 3d world for more info look the transform node , sfvec3f field
scale: the scale of the shape in the 3d world for more info look the transform node , sfvec3f field
rotation: the rotation of the shape in the 3d world for more info look the transform node , sfrotation field
geometry : this field can't be changed , the type of geometry of the shape , for more info look the shape node , sfnode field
transparency : the transparency of the shape , for more info look the Material node , sffloat field
shininess : the shininess of the shape , for more info look the Material node , sffloat field
ambientIntensity : the reflection of ambient light of the shape , for more info look the Material node , sffloat field
diffuseColor : the color of the shape , clicking the button you can select the color visually, for more info look the Material node , sfcolor field
emissiveColor : the emissive color of the shape,clicking the button you can select the color visually , for more info look the Material node , sfcolor field
specularColor : the color of the specular hilights of the shape ,clicking the button you can select the color visually, for more info look the Material node , sfcolor field
Texture : the texture type , for more information look the Image Texture node , Movie Texture Node , , the appearance node , The sfnode field
Texture url : the url of the texture file, clicking the button you can open a dialog to choose the image from the folder and preview it, for more information look the Image Texture node , and the Movie Texture Node , mfstring field
Texture loop: if the movie texture will loop or play once , for more information look at the Movie Texture Node and the sfbool field
The modify button: will make the changes you made in the fields visible on the selected shape
The delete button : will remove the selcted shape from the world
The clone button will copy the selected shape in its actual state and position, the shape can be still modied after cloned, the modifications about position will move only the shape and not the clone, the modifications about the appearance (like colors and textures) will change the shape and all the clones.
The make animable button will make animable the shape, if a shape is made animable it can't be modified anymore,so the fields aren't visible anymore and you can see only the animation button.
the make animable saves an externalproto for animations in the same folder of the vrml file, this external proto must be in the same folder of your vrml file for the animation to work.The animation button: will open the animation form
The animation form:in the time field write the seconds of your animation for example 15 ,(for more info look at sftime field and the timesensor node) in the loop field write TRUE if your animation will begin again and again after the end, write FALSE if the animation will stop after play once.(for more info look at sfbool field)
in the translations , rotations and scales fields you can write for each frame these values.(for more info look the transform node , sfrotation field , sfvec3f field , positioninterpolator node and the orientationinterpolator node)
The animation works in this way , you write a time (for example 10 seconds) this time is divided in 5 frames, 4 frames and then the first again. for each one of the frames you can write values for translation, rotation and scale. and they will change in time when the frame is played.Top orange frame: The top orange frame is visible only when a shape is selected and it's being modified.
It has inside fields specific for each shape, for example if the shape modified is a sphere the top orange frame will have title "sphere" and a field for the radius of the sphere, some shape types have fields that can be modified, some other shape types ( like indexed face set or indexed line set )can't be modified in the editor , you should change them in the vrml code.
the shapes type that can be modified are box , sphere , cylinder , cone and text . for more informations look at the sphere node,the box node, the cylinder node,the cone node and the text node , other shape types can be found also in the node reference
The violet frame:
The world inside the editor can be in two states, the selection state and
the navigation state, in the navigation state is normal, in the selection
mode many shapes inside the world can be clicked, clicking a shape will select
it, then you can go back in the normal state, navigation mode in two ways:
clicking on navigation mode or clicking on modify selected, in the second
way the shape that you selected will be modificable, all its fields will be
displayed in the orange frames and they can be modified.
in the center of the violet frame there is a label that displays the selection
or navigation mode, in selction mode diplays the geometry of the selected
shape, like sphere , cone ecc....
All the changes you make to the vrml world aren't still there for real, you
can see them but if you look in the vrml code they aren't there, so to select
and modify the changed and added shapes you need to click on apply, this will
add al the changes you made to the real vrml code and the new and modified
shapes can now be selected, discrard changes can instead cancel all the new
and modified object reloading the world as it was the last time you clicked
on apply.
The selection mode button : will make all the shapes supported by the editor clickable, clik a shape to select it, in selection mode you can't apply changes , save ecc... because the world is not in a normal state.
The navigation mode button: takes the vrml world back to his normal state.
The modify selected button :takes the vrml world back to his normal state and writes the values of some field of the shape in the orange frames, all this fields can then be modified.
The apply button saves the world in a temporary file , and all the changes made from the last time you cliccked on apply will become real.
The discard changes button reload the world from the temporary file where it was saved the last time you clicked on apply, and all the changes made from that time will be cancelled
The blue frame:this frame is for adding objects to the 3d world, the red position field is the positon in the 3d space where the object will be added all the other buttons and fields are the objet that you can add, when added an object will be white and with dimensions 1 1 1, you can modify the object later, the text size instead will depend fron the text length, the object loaded from disk will have the same dimensions and materials of the vrml file loaded.
field position: the coordinates of the 3d space where the object will be added, (for more info look the transform node (translation field),and the sfvec3f field)
my position button: this button will write your actual positon in the 3d space into the position field
Sphere button: this button will add a sphere in the world in the position you wrote in the position field (for more informations look at the sphere node)
Cylinder button:this button will add a cylinder in the world in the position you wrote in the position field (for more informations look at the cylinder node)
Box button:this button will add a box in the world in the position you wrote in the position field (for more informations look at the box node)
Cone button:this button will add a cone in the world in the position you wrote in the position field (for more informations look at the cone node)
Text field: this field is the text that will be added when the text button will be clicked(for more informations look at the text node)
Text button:this button will add a text (the one written in the text field in the world in the position you wrote in the position field (for more informations look at the text node)
viewpoint field and button: this will add to the vrml world a viewpoint with the name written in the field in your actual viewpoint( for more informations look at the viewpoint node)
browse button ,object field and object button: these are for adding an object to the world loading it from your computer, the browse button will load a form with all the disks and floders and vrml files on your computer, you can select a vrml file and click on open to write the file path and name into the object field, you can also manually write the path and the name into the object field, then click on object to add the object to the world in the position written in the position field , the object will mantain its original vrml code so dimensions and colors will be the same like the file loaded, if in the file loaded there where many shapes they can be selected and modified one by one and not alltoghether.
The dark red frame: this frame will display a small help , clicking on any field or moving the mouse on any button will write the help in the dark red frame for that field or button, if using the editor there is an error a small text field will open with informations about the error , you can close the text field clicking the ok button
The gray frame : this frame displays informations about your position in the world, there are the coordinate of the position (X)..(Y)...(Z)... and your rotation in the 3d space, you can use this informations to find a good place for your objects, there is also the frame rate: fps:........... when you open an empty world it 's very high, when you add some objects the frame rate decrease, if the objects are tooomany the frame rate can become too low and the 3d world is rendered too slowly, so look when you modify the world if the framerate decrease.
chiudi menu