Skip to main content

VQS (Virtual Quality Standard) – JSON Structure Documentation

Updated over 2 weeks ago

1. Overview

A VQS is a JSON package that defines:

  • Light configurations

  • Render/export presets

  • Avatar settings

  • General rendering settings

  • File mappings to individual .exp preset files

Each .exp file contains a serialized JSON object that defines a single render/export preset.

2. VQS Top-Level Structure

Example VQS JSON

{ "name": "vqs_example", "content": { "files": { ... }, "lights": [ ... ], "presetLights": [], "presets": [ ... ], "settings": [ ... ] } }

2.1 Top-Level Fields

Field

Type

Description

name

string

Name of the VQS package

content

object

Contains all preset, light and settings definitions

3. content Object Structure

3.1 content.files

Dictionary of file paths mapped to JSON content (stringified JSON).

Field

Type

Description

key

string

Relative path (e.g., presets/front.exp)

value

string

Stringified JSON representing preset/light/settings

3.2 content.presets

List of render presets included in the VQS.

Example

{ "default": true, "imageCount": 1, "name": "Export Test_front", "presetName": "Export Test_front", "renderPresetName": "Export Test_front", "src": "presets/Export Test_front.exp" }

Fields

Field

Type

Description

default

boolean

Indicates default preset

imageCount

integer

Number of images rendered

name

string

Display name

presetName

string

Internal preset name

renderPresetName

string

Render engine preset name

src

string

Path to .exp preset file

3.3 content.lights

Defines light configurations.

Field

Type

Description

default

boolean/null

Is default light setup

index

integer

Light index

name

string

Light group name

src

string

Path to light .exp


3.4 content.settings

References additional configuration JSON files.

4. Preset (.exp) JSON Structure

Each .exp file contains a serialized JSON object describing one preset.

5. Preset Attributes Documentation

Below is a grouped explanation of all possible attributes.

5.1 Export Configuration

Attribute

Type

Possible Values

Description

alphaMode

string

"BLEND", "OPAQUE"

Transparency mode

autoCrop

boolean

true / false

Automatically crop rendered image

background

array[string]

"transparent" or color values

Background setting

dpi

integer

e.g. 72, 300, 600

Output DPI

embedColors

boolean

true / false

Embed color profile

exportInner

boolean

true / false

Export internal garment surfaces

exportType

string

"image", "fbx", "gltf", "usd"

Export type

fbxBmpTga

boolean

true / false

?

fbxEmbedOffset

boolean

true / false

?

fbxMatchGarment

boolean

true / false

?

fbxScale

number

e.g. 1, 10

FBX scale multiplier

fbxType

string

"binary", "ascii"

FBX format type

fbxUpAxisY

boolean

true / false

Use Y as up axis

fbxVersion

string

e.g. "FBX201400"

FBX version

fbxZipExport

boolean

true / false

Zip FBX output

fileFormat

string

"png", "jpg", etc.

Image format

garmentId

string

numeric string

Garment identifier

garmentThickness

boolean

true / false

Include garment thickness

geometryCompression

boolean

true / false

Enable geometry compression

gltfType

string

"gltf", "glb"

GLTF format

gltfViewer

string

"khronos"

GLTF viewer type

height

integer

pixels

Base height

heightRender

integer

pixels

Render height

heightShare

integer

pixels

Share/preview height

isBakedTextures

boolean

true / false

Use baked textures

isCloudProcessingChecked

boolean / null

true / false / null

Cloud processing flag

isPackUV

boolean

true / false

Pack UVs

isQuadsTopology

boolean

true / false

Use quad topology

layoutUvType

integer

e.g. 0–4

UV layout mode

linked

boolean

true / false

?

multipack

boolean

true / false

Enable multipack

outlineGarment

boolean

true / false

Show garment outline

pbrMaterialType

string

"metallic", "specular"

PBR material workflow

pbrModel

string

"metallic", "specular"

PBR model

quality

string

"" or quality label

Render quality

rayTrace

integer

0, 1, etc.

Ray tracing level

reduceBwFile

boolean / null

true / false / null

Reduce Browzwear file

saveImagesToOneDir

boolean

true / false

Save all images in one directory

schematic

boolean

true / false

Enable schematic mode

schematicContourColor

array[4]

RGBA

Contour color

schematicContourThickness

integer

pixels

Contour thickness

schematicCutMarkThickness

integer

pixels

Cut mark thickness

schematicDrapeLineThickness

integer

pixels

Drape line thickness

schematicGarmentColor

array[4]

RGBA

Garment color

schematicInternalLineColor

array[4]

RGBA

Internal line color

schematicInternalLineThickness

integer / null

pixels

Internal line thickness

schematicSeamLineThickness

integer

pixels

Seam line thickness

schematicShadowContrast

number

0–1

Shadow contrast

schematicShowArtwork

boolean

true / false

Show artwork in schematic

schematicStitchesScale

number

scale factor

Stitches scale

separateGarmentDetails

boolean

true / false

?

showAvatar

boolean

true / false

Show avatar

textureCompression

boolean

true / false

Enable texture compression

textureHeight

integer

pixels

Texture height

textureUvDpi

integer

DPI

Texture UV DPI

textureWidth

integer

pixels

Texture width

turntableFileSize

string

"small", "medium", "large"

Turntable output size

turntablePreset

string

"simple"

Turntable preset

turntableType

string

"html"

Turntable export type

uploadBwFile

boolean / null

true / false / null

Upload Browzwear file

usdType

string

"binary", "ascii"

USD format

useDpiRes

boolean

true / false

Use DPI for resolution

useMaterialNames

boolean

true / false

Use material names

usePatternNames

boolean

true / false

Use pattern names

ver

integer

e.g. 3

Preset version

weld

boolean

true / false

Weld geometry

width

integer

pixels

Base width

widthRender

integer

pixels

Render width

widthShare

integer

pixels

Share/preview width

overrideDefaultAvatars

boolean

true / false

Override default avatars

isBwCompat

boolean

true / false

Browzwear compatibility flag

5.2 Lighting

light Object

"light": { "name": "Studio Dim Backlight.hdr", "exposure": 0, "rotation": 0, "enabled": true, "castShadow": true, "linkToCamera": true }

Field

Type

Description

name

string

HDRI file name

exposure

number

Exposure value

rotation

number

Rotation in degrees

enabled

boolean

Enable light

castShadow

boolean

Cast shadows

linkToCamera

boolean

Rotate with camera

5.3 Scene / Camera

scene Object

"scene": { "fov": 27.99, "lookAt": [x,y,z] or null, "viewAngle": number, "viewPos": [x,y,z], "viewRot": [x,y,z,w] }

Field

Type

Description

fov

float

Field of view

lookAt

array[3] or null

Target point

viewAngle

float

Camera angle

viewPos

array[3]

Camera position

viewRot

array[4]

Quaternion rotation

5.4 FBX Export Settings

Field

Type

Values

fbxType

string

"binary", "ascii"

fbxVersion

string

e.g. "FBX201400"

fbxScale

number

scale factor

fbxUpAxisY

boolean

fbxZipExport

boolean

fbxBmpTga

boolean

fbxEmbedOffset

boolean

fbxMatchGarment

boolean

5.5 GLTF / USD

Field

Type

Values

gltfType

string

"gltf", "glb"

gltfViewer

string

"khronos"

usdType

string

"binary", "ascii"

5.6 PBR / Materials

Field

Type

Values

pbrMaterialType

string

"metallic", "specular"

pbrModel

string

"metallic", "specular"

useMaterialNames

boolean

usePatternNames

boolean

5.7 Texture Settings

Field

Type

Description

textureWidth, textureHeight

integer

Texture resolution

textureUvDpi

integer

UV DPI

textureCompression

boolean

Enable compression

isBakedTextures

boolean

Use baked textures

isPackUV

boolean

Pack UVs

layoutUvType

integer

Layout mode

5.8 Schematic Mode

Field

Type

schematic

boolean

schematicContourColor

array[4] (RGBA)

schematicGarmentColor

array[4]

schematicShadowContrast

float

schematicShowArtwork

boolean

Thickness fields

integer

5.9 Avatar Settings

"avatar": { "name": null, "type": null, "poseId": null, "poseName": null, "adf": null }

Field

Type

showAvatar

boolean

overrideDefaultAvatars

boolean

avatars

array

avatar

object

5.10 Turntable

Field

Type

Values

turntableType

string

"html"

turntablePreset

string

"simple"

turntableFileSize

string

"small", "medium", "large"

turntableCustom

object

Custom config

5.11 Miscellaneous

Field

Type

rayTrace

integer

quality

string

geometryCompression

boolean

reduceBwFile

boolean/null

uploadBwFile

boolean/null

ver

integer (preset version)

weld

boolean

linked

boolean

multipack

boolean

multipackPreset

object

isBwCompat

boolean


6. Example – Minimal Preset

{ "exportType": "image", "fileFormat": "png", "width": 3000, "height": 3000, "dpi": 300, "alphaMode": "BLEND", "background": ["transparent"], "light": { "name": "Studio.hdr", "exposure": 0, "rotation": 0, "enabled": true }, "scene": { "fov": 28, "viewPos": [0, -100, 400], "viewRot": [0, 0, 0, 1] } }


7. Summary

A VQS:

  • Is a container of render/export presets

  • References individual .exp preset JSON files

  • Controls lighting, export format, camera, textures, materials, avatar, and advanced export options

A Preset:

  • Fully defines a render/export configuration

  • Supports image, FBX, GLTF, USD, turntable exports

  • Contains lighting + camera configuration

  • Contains rendering + material settings

  • Contains export format configuration

Did this answer your question?