dense-caption-capability#

Code

DC.001

Validator

Compatibility

core usd

Tags

🔑

Summary#

The Root Prim must inlcude documentation metadata that describes the 3D Asset.

Description#

The root prim of the asset must contain documentation metadata, holding a Dense Caption string. This additional description helps identify the asset with more detail than semantic labels.

Why is it required?#

  • Dense captions provide richer semantic information useful for AI training and scene understanding.

Examples#

# Invalid: No dense caption

def XForm "SportCar" (
)
{
    ...
}

# Valid: Dense caption

def XForm "SportCar" (
    doc = "This is a red, two door sports car with a tan, leather interior and chrome wheels. The driver's window is up and the headlights are off."
)
{
    ...
}

How to comply#

  • Set the doc metadata string of the root prim to a dense caption. Python Snippet:

    
from pxr import Usd, UsdGeom

# Get the root prim
stage = Usd.Stage.Open("sportsCar.usd")
root_prim = stage.GetPrimAtPath("/SportsCar")
root_prim.SetDocumentation("This is a dense caption that describes the asset.")

For More Information#