Skip to main content

Add 3D Elements via a CSV File

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.