@inweb/viewer-three 25.3.15

package/LICENSE

@@ -0,0 +1,20 @@
+Copyright (C) 2002-2021, Open Design Alliance (the "Alliance").
+All rights reserved.
+
+This software and its documentation and related materials are owned by
+the Alliance. The software may only be incorporated into application
+programs owned by members of the Alliance, subject to a signed
+Membership Agreement and Supplemental Software License Agreement with the
+Alliance. The structure and organization of this software are the valuable
+trade secrets of the Alliance and its suppliers. The software is also
+protected by copyright law and international treaty provisions. Application
+programs incorporating this software must include the following statement
+with their copyright notices:
+
+  This application incorporates Open Design Alliance software pursuant to a
+  license agreement with Open Design Alliance.
+  Open Design Alliance Copyright (C) 2002-2021 by Open Design Alliance.
+  All rights reserved.
+
+By use of this software, its documentation or related materials, you
+acknowledge and accept the above terms.

package/README.md

@@ -0,0 +1,63 @@
+# Viewer.three
+
+`Viewer.three` is a JavaScript library powered by [Three.js](https://threejs.org/) for in-browser visualization of 3D CAD and BIM data from `glTF` files stored on the [Open Cloud Server](https://cloud.opendesign.com/docs/index.html#/opencloud_server), on the web, or on your local computer.
+
+This library enables you to easily integrate advanced visualization capabilities into your web applications, including user interaction with scenes and objects, markups, and collaboration using the [inWEB Open Cloud](https://www.opendesign.com/products/open-cloud) platform.
+
+> `glTF` is a [royalty-free](https://www.khronos.org/gltf) file format commonly used in 3D applications.
+
+## Installation
+
+### CDN or static hosting
+
+For CDN, you can use [unpkg](https://unpkg.com/) or [jsDelivr](https://www.jsdelivr.com/) (replace `25.3` with a version you need):
+
+```html
+<script src="https://unpkg.com/@inweb/viewer-three@25.3/dist/viewer-three.js"></script>
+```
+
+The global namespace for `Viewer.three` is `ODA.Three`.
+
+### Install via [npm](https://npmjs.org)
+
+Open a terminal in your project folder and run:
+
+```sh
+npm install @inweb/viewer-three
+```
+
+The `Viewer.three` package will be downloaded and installed. Then you're ready to import it in your code:
+
+```javascript
+import { Viewer } from "@inweb/viewer-three";
+```
+
+## Example
+
+Download and render file from the `Open Cloud Server`:
+
+```html
+<script src="https://unpkg.com/@inweb/client@25.3/dist/client.js"></script>
+<script src="https://unpkg.com/@inweb/viewer-three@25.3/dist/viewer-three.js"></script>
+
+<script>
+  const client = new ODA.Api.Client({ serverUrl: "https://cloud.opendesign.com/api" });
+  const viewer = new ODA.Three.Viewer(client);
+
+  init();
+
+  async function init() {
+    await client.signInWithEmail("email", "password");
+    const files = await client.getFiles();
+    await viewer.initialize(canvas);
+    await viewer.open(files.result[0]);
+    viewer.setActiveDragger("Orbit");
+  }
+</script>
+```
+
+To learn more, see [First application guide](https://cloud.opendesign.com/docs/index.html#/guide).
+
+## Copyright and license
+
+Code and documentation copyright 2002-2024 the [Open Design Alliance](https://opendesign.com). Code is distributed under a proprietary license, see [LICENSE](./LICENSE) for more information.