UmbraFileImportParams struct

File import parameters.

Public variables

UmbraBool zIsUp
true if the scene uses a Z-up coordinate system, false if Y-up.
UmbraBool rightHanded
true if the scene uses a right-handed coordinate system.
float objSplitWidth
OBJ files get divided into sub-meshes.
const char* xyzFieldString
If the file is an XYZ point cloud, you need to specify what each column in the dataset represents.
UmbraFloat3 origin
A point that gets subtracted from all points in the point cloud or from all vertices in mesh when importing.
UmbraFloat3 lasOrigin
union UmbraFileImportParams::@0 @1
UmbraFloat3 rgbScale
Constants that gets multiplied by the red/blue/green channels when importing a point cloud.
const char* utmZone
Universal Transverse Mercator zone.

Variable details

float UmbraFileImportParams::objSplitWidth

OBJ files get divided into sub-meshes.

This value is the maximum size of each sub-mesh, in model units.

This value is only used when importing OBJ files, and is ignored for other formats.

const char* UmbraFileImportParams::xyzFieldString

If the file is an XYZ point cloud, you need to specify what each column in the dataset represents.

Supported fields are:

  • x/y/z: the x/y/z coordinate.
  • intensity: ignored if you also have red/green/blue fields, otherwise intensity gets mapped to some arbitrary color ramp.
  • red/green/blue: the red/green/blue color channel.
  • nx/ny/nz the x/y/z components of the normal vector.
  • lon/long/longitude: the longitude.
  • lat/latitude: the latitude.
  • elevation: the elevation.

You may also pass in fields as integers, corresponding to values in the UmbraPointAttributeName enum.

The default field string is x y z intensity red green blue.

UmbraFloat3 UmbraFileImportParams::origin

A point that gets subtracted from all points in the point cloud or from all vertices in mesh when importing.

Useful for centering the geometry at the origin.

UmbraFloat3 UmbraFileImportParams::rgbScale

Constants that gets multiplied by the red/blue/green channels when importing a point cloud.

For XYZ files, this defaults to all ones. For LAS files, this defaults to 65535^-1. This value is ignored for other formats.

const char* UmbraFileImportParams::utmZone

Universal Transverse Mercator zone.

Must be the longitudal zone number, followed by 'N' or 'S' to specify the northern/southern hemisphere. For example "35N".

This value is only used when importing LAS point clouds, and is ignored for all other formats.