Preferences

Configuring preferences and settings in the Asset Transformer SDK.

Read time 7 minutes

Last updated 21 hours ago

Use the core.setModuleProperty function to set preferences.

pxz.core.setModuleProperty("Core", "ThreadCount", "20")

Tip

Use core.listModuleProperties to list the properties of a module.

Module	Property	Type	Default Value	Description
Algo	DisableGPUAlgorithms	Boolean	`False`
CAD	UnitLength	Distance	`0.02`
CAD	TangencyAngle	Angle	`10`
CAD	CurvatureThreshold	Real	`0.02`
CAD	CurvatureRatio	Real	`0.5`
CAD	CurveMaxSplit	Int	`10000`
CAD	SurfaceMaxSplit	Int	`1500000`
Core	ThreadCount	Int	`12`
Core	EnableDebugLog	Boolean	`False`	Enable advanced debug log generation. Log file is available at: %APPDATA%/{ProductName}/lastSession{Id}.log.
Core	EnableUndoRedo	Boolean	`False`	Enable the Undo Redo system. Will result in higher memory consumption.
Core	EnableOocMode	Boolean	`False`	Save meshes and models out of core to save RAM.
IO	PartialLoad	Boolean	`False`	Components will only be loaded when manually triggered (currently supported formats: plmxml, jt, pvz).
IO	AssetPaths		`[]`	User-defined paths to find assets.
IO	LoadHidden	Boolean	`False`	Choose to import parts which visibility status is set to false.
IO	LoadSuppressed	Boolean	`True`
IO	LoadConstructionTree	Boolean	`True`
IO	LoadConstructionAndReference	Boolean	`False`
IO	LoadVariant	Boolean	`False`
IO	AliasApiDllPath	FilePath	``	Path of an Alias dll to import .wire files.
IO	AliasImportMode	Enum: Import by object, Import by layer, Import by layer (one part by layer)	`Import by layer (one part by layer)`
IO	AliasImportEmptyLayer	Boolean	`False`
IO	AliasImportSymmetries	Boolean	`True`
IO	RecapSDKPath		``
IO	RecapLoadPointOfView	Boolean	`False`
IO	VredExecutablePath	FilePath	``	Path of VRED executable to import .vpb files.
IO	LoadPMI	Boolean	`False`	Use this option to include FTA or PMI when importing a CAD file.
IO	PreferLoadMesh	Boolean	`False`
IO	RhinoOnePartByLayer	Boolean	`True`
IO	CreoViewModelGeometrySolids	Boolean	`True`	Model Geometry Solids.
IO	CreoViewModelGeometrySurfaces	Boolean	`True`	Model Geometry Surfaces.
IO	CreoViewModelGeometryCosmetics	Boolean	`True`	Model Geometry Cosmetics.
IO	CreoViewModelConstructionGeometrySurfaces	Boolean	`False`	Model Construction Geometry Surfaces.
IO	CreoViewModelConstructionGeometryCosmetics	Boolean	`False`	Model Construction Geometry Cosmetics.
IO	CreoViewModelConstructionGeometryDatum	Boolean	`False`	Model Construction Geometry Datum.
IO	CreoViewModelConstructionGeometryCoordinateSystems	Boolean	`False`	Model Construction Geometry Coordinate Systems.
IO	ImportLayerMode	Enum: Import default layer, Import each layer as occurrences, Import each layer as variants	`Import default layer`
IO	PreferAlternativeImporters	Boolean	`False`	Up to two different import implementations exist for some formats.
IO	FlipCoordinateSystem	Boolean	`True`	Automatically convert any imported model orientation when possible.
IO	AutoCreateSTLNormals	Boolean	`True`
IO	ImportAnimations	Boolean	`True`
IO	AutoTessellate	Boolean	`False`
IO	AutoTessellateRepairTolerance	Distance	`0.10000000000000001`
IO	AutoTessellateMaxSag	Distance	`0.20000000000000001`
IO	AutoTessellateMaxAngle	Angle	`-1`
IO	AutoTessellateUVMode	Enum: NoUV, FastUV, UniformUV	`NoUV`
IO	AutoTessellateUVChannel	Int	`1`
IO	AutoTessellateCreateTangents	Boolean	`False`
IO	AutoTessellateCreateFreeEdges	Boolean	`False`
IO	UpAxis	Enum: Y-UP, Z-UP, X-UP	`Y-UP`	Use to define the Up-axis of the exported files. Affects FBX and USD formats only.
IO	FbxVersion	Enum: 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020	`2020`
IO	FbxEmbeddedTextures	Boolean	`True`
IO	FbxExportAscii	Boolean	`False`
IO	PMIReplaceBlackColor	Color	`[0, 0, 0]`	Automatically replace PMI colors. Black by default. White strongly recommended for AR use.
IO	ExportHiddenParts	Boolean	`False`
IO	ExportAnimations	Boolean	`True`
IO	ExportMetadata	Boolean	`True`
IO	FilterPointCloudBoundingBox		`[[1000000000000, 1000000000000, 1000000000000],[-1000000000000, -1000000000000, -1000000000000]]`
IO	PointCloudImportMode	Enum: Import point cloud, Import bounding box only, Import one bounding box by part	`Import point cloud`
IO	UseFilePrecision	Boolean	`False`
IO	MergeVariantsAtImport	Boolean	`False`
IO	ImportRealisticMaterials	Boolean	`False`
IO	Export3DTilesMaxDepth	Int	`0`	If > 0, produces multiple 3DTiles (external content) using the given maximum depth.
IO	ExportGLTFApplyScale	Boolean	`False`
IO	ExportGLTFLights	Boolean	`True`
IO	ExportGLTFInterleaved	Boolean	`False`
IO	ExportGLTFExternalTextures	Boolean	`False`	Force external texture in GLB export.
IO	ExportGLTFOverrideExistingTextures	Boolean	`False`	If true, external textures will be named '<name>_<id>.<ext> and existing file with same name will be overrided'.
IO	ExportGLTFDraco	Boolean	`False`
IO	GLTFDracoQuantizationPosition	Int	`11`
IO	GLTFDracoQuantizationNormal	Int	`8`
IO	GLTFDracoQuantizationTexCoord	Int	`10`
IO	GLTFDracoQuantizationVertexColor	Int	`8`
IO	GLTFDracoCompressionLevel	Int	`7`
IO	ExportPrefabKeepRootTransform	Boolean	`False`
IO	ForceShadedMaterial	Boolean	`True`
IO	NwdUseInstancing	Boolean	`True`
IO	JtExportVersion	Enum: 8.1, 9.5, 10.0	`10.0`	"8.1", "9.5" or "10.0".
IO	Windowed	Boolean	`False`	Start VRED in a window.
IO	PrintMissingFiles	Boolean	`False`
Material	ExportTextureFormat	Enum: PNG, JPEG, KTX2	`PNG`
Material	JpegQuality	BoundedInteger	`[95, 0, 100]`
Material	PngCompression	BoundedInteger	`[1, 0, 9]`
Material	UseUASTC	Boolean	`False`
Material	KtxQuality	BoundedInteger	`[128, 1, 255]`
Material	KtxCompression	BoundedInteger	`[2, 1, 5]`
Material	EnableImageOoC	Boolean	`False`
Material	ImageOoCPath		``
Material	KtxYDown	Boolean	`True`	Export Y down KTX.
Scene	AnimationSampling	Int	`1`
Scene	GlobalSceneLockEnabled	Boolean	`True`	Use read/write lock in scene manipulation. Disable at your own risks.
View	UseVulkanValidation	Boolean	`False`	Enable Vulkan Validation Layers (need to be done before viewer creation).
View	UseGPUTimes	Boolean	`False`	Enable uses of GPU Times marker.

Documentation

Engine

Services

Grow

Industry

Support

Asset Transformer SDK

User Manual

Python API

C# API

Changelog

Asset Transformer SDK

Preferences

Module

Property

Type

Default Value

Description