DOCS-3540: Add camera samples (#502)

Author: npentrel

src/components/camera/camera.ts

@@ -33,6 +33,29 @@ export interface Camera extends Resource {
   /**
    * Return a frame from a camera.
    *
+   * @example
+   *
+   * ```ts
+   * const camera = new VIAM.CameraClient(machine, 'my_camera');
+   * const image = await camera.getImage();
+   *
+   * // Convert Uint8Array to base64
+   * const base64Image = btoa(
+   *   Array.from(image)
+   *     .map((byte) => String.fromCharCode(byte))
+   *     .join('')
+   * );
+   *
+   * // Convert image to base64 and display it
+   * const imageElement = document.createElement('img');
+   * imageElement.src = `data:image/jpeg;base64,${base64Image}`;
+   * const imageContainer = document.getElementById('#imageContainer');
+   * if (imageContainer) {
+   *   imageContainer.innerHTML = '';
+   *   imageContainer.appendChild(imageElement);
+   * }
+   * ```
+   *
    * @param mimeType - A specific MIME type to request. This is not necessarily
    *   the same type that will be returned.
    */
@@ -41,14 +64,40 @@ export interface Camera extends Resource {
   /**
    * Render a frame from a camera to an HTTP response.
    *
+   * @example
+   *
+   * ```ts
+   * const camera = new VIAM.CameraClient(machine, 'my_camera');
+   * const mimeType = 'image/jpeg';
+   * const image = await camera.renderFrame(mimeType);
+   * ```
+   *
    * @param mimeType - A specific MIME type to request. This is not necessarily
    *   the same type that will be returned.
    */
   renderFrame: (mimeType?: MimeType, extra?: Struct) => Promise<Blob>;
 
-  /** Return a point cloud from a camera. */
+  /**
+   * Return a point cloud from a camera.
+   *
+   * @example
+   *
+   * ```ts
+   * const camera = new VIAM.CameraClient(machine, 'my_camera');
+   * const pointCloud = await camera.getPointCloud();
+   * ```
+   */
   getPointCloud: (extra?: Struct) => Promise<Uint8Array>;
 
-  /** Return the camera properties. */
+  /**
+   * Return the camera properties.
+   *
+   * @example
+   *
+   * ```ts
+   * const camera = new VIAM.CameraClient(machine, 'my_camera');
+   * const properties = await camera.getProperties();
+   * ```
+   */
   getProperties: () => Promise<Properties>;
 }