Login

Help

Add 3D elements via a CSV file

In this article, you will learn how to add primary 3D elements via a CSV file.

csv
XYZ

It is possible to add primary 3D elements with a CSV file. The separator of the CSV must be the semicolon (;). Here is an example of a table (can be exported in CSV) containing all available types (7 in total):

It is important to respect the order of the fields and to start on column A (the first column).

Explanation of the different fields:

  • TYPE: this is the type of element to add (the 7 types in the example are the only ones available and will be detailed later in the article)
  • NAME: this is the name you want to give to your elements (no restrictions)
  • POS_X, POS_Y and POS_Z: these are the insertion coordinates of the element (the center of the element)
  • ROT_X, ROT_Y and ROT_Z: these are the rotations of the element expressed in degrees
  • SCALE_X, SCALE_Y and SCALE_Z: these 3 values determine the size of the element according to its type (we will detail later)
  • COLOR: this is the color of the element, expressed in hexadecimal (note that you must put the # in front)

 

To add a CSV in the viewer, just click on the file icon (modify scene / objects) then on the CSV file icon.

Then select your CSV file and the elements will automatically be added to the viewer if the CSV is correct.

 

You will find each shape in the scene menu, you will be able to change the color and delete them independently.

The different types:

  • Box:
    • The SCALE_X, SCALE_Y and SCALE_Z values determine its size along the different axes, expressed in meters.

 

  • Plane :
    • The SCALE_X and SCALE_Y values determine its size along the different axes expressed in meters, but the SCALE_Z value is not used.

 

  • Sphere:
    • The SCALE_X value determines its radius, expressed in meters. The SCALE_Y and SCALE_Z values are not used.
    • Rotation values are 0.

 

  • Circle:
    • The SCALE_X value determines its radius, expressed in meters. The SCALE_Y and SCALE_Z values are not used.

 

  • Cross:
    • The SCALE_X value determines the length of the cross, expressed in meters. The SCALE_Y and SCALE_Z values are not used.

 

  • Line:
    • The values POS_X, POS_Y and POS_Z determine the first point of the line.
    • The ROT_X, ROT_Y and ROT_Z values determine the second point of the line.
    • SCALES values are not used.

 

  • Target:
    • The SCALE_X value determines the length of an axis from the center. The SCALE_Y and SCALE_Z values are not used.
    • Rotation values are 0.

 

In case of problem or difficulty, do not hesitate to contact the platform team.
 

Were these informations useful to you ?
Editor : Alexis Helper
Creator : Alexis Helper
Last modification : 28/08/2023

About cookies on this site

We use cookies for the proper functioning of the website and to analyse website performance and usage information