=============================
Supported USD Primitive Types
=============================

USD is an extensive library, and below we have provided a table of the default USD primitive types and whether we support reading them into a Katana project. This does not describe what kind of support renderers or the viewport have in relation to these, just whether we support reading them from USD files into scene graph locations. It is worth noting that we import more types than those listed here, as there is generic type importing where we read any attribute set on a USD node. However, this is a list of the types we handle with specific definitions or attributes, especially those types which correspond to Katana attribute conventions.


Cameras
-------
.. csv-table::
    :header: "PrimName", "Supported", "Detail"
    :widths: 30, 10, 70

    UsdGeomCamera, Yes,

Curves
------
.. csv-table::
    :header: "PrimName", "Supported", "Detail"
    :widths: 30, 10, 70

    UsdGeomBasisCurves, Yes, "Supported basis' bezier, (b-spline, catmull-rom, hermite, power), if default renderer is RenderMan, we set basis under prmanStatements.basis.u and prmanStatements.basis.v (as per USD 19.05 original KatanaUsdPlugins), otherwise we set the correct integer value on geometry.basis"
    UsdGeomNurbsCurves, Yes,
    UsdGeomCurves, Yes, This is the base class for UsdGeomBasisCurves and UsdGeomNurbsCurves.

Geometry
--------
.. csv-table::
    :header: "PrimName", "Supported", "Detail"
    :widths: 30, 10, 70

    UsdGeomCapsule, Yes,
    UsdGeomCone, Yes,
    UsdGeomCube, Yes,
    UsdGeomCylinder, Yes,
    UsdGeomGprim, Yes,
    UsdGeomMesh, Yes,
    UsdGeomNurbsPatch, Yes,
    UsdGeomPointInstancer, Yes,
    UsdGeomScope, Yes,
    UsdGeomSphere, Yes,
    UsdGeomXForm, Yes,


Lights
------
.. csv-table::
    :header: "PrimName", "Supported", "Detail"
    :widths: 30, 10, 70

    UsdLuxDiskLight, Yes, "parameters under usdLuxLightParams, shader type under usdLightShader"
    UsdLuxDistantLight, Yes, "parameters under usdLuxLightParams, shader type under usdLightShader"
    UsdLuxDomeLight, Yes, "parameters under usdLuxLightParams, shader type under usdLightShader"
    UsdLuxGeometryLight, Yes, "parameters under usdLuxLightParams, shader type under usdLightShader"
    UsdLuxMeshLight, Yes, "parameters under usdLuxLightParams, shader type under usdLightShader"
    UsdLuxRectLight, Yes, "parameters under usdLuxLightParams, shader type under usdLightShader"

Lights - UsdRi
--------------
.. csv-table::
    :header: "PrimName", "Supported", "Detail"
    :widths: 30, 10, 70

    UsdRiPxrEnvDayLight, Yes,
    UsdRiPxrAovLight, Yes,

Light Filters
-------------
.. csv-table::
    :header: "PrimName", "Supported", "Detail"
    :widths: 30, 10, 70

    UsdLuxLightFilter, Yes,  "Base class for the UsdRi light filters, not read by itself currently"
    UsdRiPxrBarnLightFilter, Yes,
    UsdRiPxrCookieLightFilter, Yes,
    UsdRiPxrIntMultLightFilter, Yes,
    UsdRiPxrRampLightFilter, Yes,
    UsdRiPxrRodLightFilter, Yes,