Open code

Download

Tools and tutorials for download


VectoroBox smart device applications



VectoroBox Marker

If you want do display your 3D models through Augmented Reality, please download the VectoroBox Marker below. This picture will act as sort of a coaster for your models. Our software will recognize the image and will display your models with the correct perspective in the 3D space. Use our smart device application and aim your device at the Marker. The model will instantly show up in front of you.


Download Marker

Print marker

Aim the camera at the Marker


The Marker is ready in a standard PDF file format for printing on an standard A4 sized paper. The Marker is 20 x 20 cm (7.87 x 7.87 in) in real life, which means that if you want to scale your models accordingly, simply create a 20 x 20 cm (7.87 x 7.87 in) plane in your favourite 3D application and place your model on that plane. That is how your model will be displayed in Augmented Reality on the marker. If you cannot scale your models, fear not, our application supports scaling of your models in real time, so you can scale down or up your models after they have been uploaded and processed.



Pre-made 3D scene file


For the correct preparation and export of your models and for your convenience, we've created a pre-made scene with the Marker placed in the correct place in the correct scale. Simply download the scene, import into your package of choice, place your models on the Marker and export them in FBX or COLLADA (DAE) for VectoroBox processing after you've logged-in (or registered, if you haven't done so yet).



Model preparation


The model should not be consiste of more than a few hundred thousand polygons (500.000 is still OK on many smart devices), however the exact amount of polygons can't be specified, because of the power of various devices. Some perform great with hundreds of thousands of polygons, some perform poorly eve with close to a hundred thousand.

If you have a prepared model and textures, import/merge it in the prepared scene in the Download section. In the scene there is a Marker placed exactly where it will be in the Augmented Reality mode with the correct scale. Adjust your model's size to this Marker's scale so that the model lays on the Marker. When all is ready, export the scene in the FBX or DAE formats and upload it to VectoroBox.

In the Studio mode the model will automatically be centered in the middle, so that the camera can see it from all sides. However, if there is a model that has any of its parts intentionally far away from the center, you can exclude it from automatic camera position calculation by simply adding a _sbb suffix to the model's name. This is only relevant for the Studio mode. In Augmented Reality mode the model will always be displayed on the marker exactly as you positioned it in your 3D program.

Model name example: Model-name_sbb

Bounding box

Automatically created bounding box. The center of the scene is being calculated with even the shadow catcher object in the scene.

Bounding box

The shadow catcher object is added _sbb as a suffix to the name. It is being ignored when calculating the scene center, which is then being calculated only from the main model in the scene.




Materials preparation


The Solid material is a simple material that is very easy to render. Any model with such a material carries the same colors as its base diffuse texture without any shading. Use JPG file types for any textures in the Solid material. If you want to use Opacity/Transparency (for example for a cast shadow), save the texture with an alpha channel in a PNG file.

Material name example: Material-name_solid

Texture names are not important, but use JPG and PNG (for transparency) formats only.


Solid texture

Diffuse texture

Solid

Material _solid


Default material is more demanding for your device's power because it's more flexible and complex. It can contain several textures: Diffuse, Normal (Bump), Specular, Reflection and Environment. The material doesn't work the same way as the Solid material, it reflects light correctly and also revflects the environment around it. Unfortunately Flash does not support such a complex shader, therefore you won't be able to see your Reflection and Environment maps together with the Specular map. So, you can either use Diffuse, Bump and Specular or Diffuse, Bump and Reflection maps. When displayed on the smart devices, everything will be the way it was intended to be with all the bells and whistles, although on certain old devices, due to their lack of power, the material might be displayed the same way as in Flash.

The name of the material isn't important, but it cannot contain the same string names as the Solid material, for example.

Texture names:

Diffuse texture:
Material-name_diff.jpg
Normal/Bump texture:
Material-name_normal.jpg or Material-name_bump.jpg
Specular texture:
Material-name_spec.jpg
Reflections texture:
Material-name_refl.jpg

Example:
Material:
Barel
Textures:
Barel_diff.jpg
Barel_bump.jpg
Barel_spec.jpg
Barel_refl.jpg

Examples of the influence the various textures have on a model:

Diffuse/Bump/Specular/Reflection

Diffuse
Bump
Specular
Reflection

*Only on iOS and Android

If you want to reflect your own environment, include a texture of the environment map with your model. The supported format is JPG and the texture has to be spherical. If you don't add your own texture a standard texture provided by us will be used.

Texture name: vb_env.jpg

Environment texture

Standard evnironment texture


There are a few pre-set materials available. There is an Environment map that is being reflected in the materials. If you don't supply your own a default one will be used.

Material names:

vb_glass0
opaque glass
vb_glass1
transparent glass
vb_brass
brass
vb_bronze
bronze
vb_chrome
chrome
vb_copper
copper
vb_gold
gold
vb_silver
silver
vb_mask
mask

Material examples:




Cut-out model usage example:

If you want to create an impression of a hole in a table, for example, you need to use a cut-out mask, which will mask out your models from the camera.
* the cut-out material works in the Augmented Reality mode only.


vb_mask

A cut-out model (hole) without a mask.

vb_mask

A cut-out model (hole) with a mask.

vb_mask

A cut-out model (hole) with a mask and an applied mask material.



Panorama preparation


You need a spherical map in order to create a 360° panorama in VectoroBox. Such a texture is usually in the 2:1 size ratio and contains the full view of the environment. The resolution of such a texture can be up to 2048x2048 (WxH) for greater detail, or smaller. Ideally 2048x1024px.

2048 x 1024px

2048 x 1024px

2048 x 2048px

2048 x 2048px