Periphery (Camera)

Capture Normals Image

Changed on

Retrieves surface normal data from the camera's captured image.

  • Pixels without geometry carry no normal and are returned as 0.0 in the json format, since JSON cannot represent the non-finite value the annotator puts there.
get/periphery/cameras/capture/normals

Request

Query parameters

result_type'json' | 'rgb_png' | 'jpeg' required

Format which will be used to represent the captured data. 'json' carries the measurements; 'rgb_png' and 'jpeg' are renderings to look at, and jpeg is lossy.

camera_prim_pathstring nullable

Path of camera prim. Leave it out to capture through the active viewport camera.

widthinteger

Image width in px

heightinteger

Image height in px

Response

Successfully fetched normals data

Changes

    • info

      the query request parameter camera_prim_path became optional

    • info

      added the new enum value jpeg to the query request parameter result_type

    • info

      query request parameter camera_prim_path list-of-types was widened by adding types null

    • info

      for the query request parameter camera_prim_path, the type was generalized from string to no type

    • info

      added the media type image/jpeg for the response with the status