Merge pull request IIIF-Commons#130 from vincentmarchetti/3dtsg-main

update to version 4.3.0-draft3dapi.0.5.0

README.md

@@ -21,6 +21,14 @@ This included in package.json
 
 will install manifesto modules into node_modules.
 
+### Demonstration Projects
+[Example manifests](https://github.com/IIIF/3d/tree/main/manifests) conforming to the [Draft API](https://github.com/IIIF/3d/blob/main/temp-draft-4.md) .
+
+[Prototype Viewers](https://github.com/IIIF/3d/issues/28) rendering the example manifests.
+- [Three-JS based viewer](https://codesandbox.io/p/github/JulieWinchester/iiif-threejs-demo)
+- [X3D/X3DOM based viewer](https://codesandbox.io/p/github/vincentmarchetti/iiif-x3dom-demo/main)
+- [Smithsonian Voyager](https://codesandbox.io/p/sandbox/voyager-annotations-demo-forked-l83l6w)
+
 ### ChangeLog
 
 From start point of the version distributed from [JulieWinchester/manifesto](https://github.com/JulieWinchester/manifesto/tree/3dtsg-dev-dist)
@@ -60,4 +68,8 @@ distributed from [vincentmarchetti/manifesto#3dtsg-main]() there were these chan
 
 #### To package.json version 4.3.0-draft3dapi.0.4.0
 
-1. Implemented Perspective Camera properties in the Camera class.
+1. Implemented Perspective Camera properties in the Camera class.
+
+#### To package.json version 4.3.0-draft3dapi.0.5.0
+
+1. Implement lookAt property of Camera class and of Light class.

dist-commonjs/Camera.d.ts

@@ -1,4 +1,4 @@
-import { IManifestoOptions, AnnotationBody } from "./internal";
+import { IManifestoOptions, AnnotationBody, PointSelector } from "./internal";
 export declare class Camera extends AnnotationBody {
  constructor(jsonld?: any, options?: IManifestoOptions);
  get isPerspectiveCamera(): boolean;
@@ -12,6 +12,10 @@ export declare class Camera extends AnnotationBody {
  Angular unit is degrees
  **/
  get FieldOfView(): number | undefined;
- getLookAt(): object | null;
+ /**
+ * @return : if not null, is either a PointSelector, or an object
+ * with an id matching the id of an Annotation instance.
+ **/
+ getLookAt(): object | PointSelector | null;
  get LookAt(): object | null;
 }

dist-commonjs/Light.d.ts

@@ -1,9 +1,11 @@
-import { IManifestoOptions, AnnotationBody, Color } from "./internal";
+import { IManifestoOptions, AnnotationBody, Color, PointSelector } from "./internal";
 export declare class Light extends AnnotationBody {
  constructor(jsonld?: any, options?: IManifestoOptions);
  get isAmbientLight(): boolean;
  get isDirectionalLight(): boolean;
+ get isSpotLight(): boolean;
  getColor(): Color;
+ get Color(): Color;
  /**
  * The implementation of the intensity is based on
  * {@link https://github.com/IIIF/3d/blob/main/temp-draft-4.md | temp-draft-4.md }
@@ -18,4 +20,29 @@ export declare class Light extends AnnotationBody {
  * This code will implement a default intensity of 1.0
  **/
  getIntensity(): number;
+ get Intensity(): number;
+ /**
+ * As defined in the temp-draft-4.md (
+ * https://github.com/IIIF/3d/blob/main/temp-draft-4.md#lights ; 12 May 2024)
+ * this quantity is the half-angle of the cone of the spotlight.
+ *
+ * The inconsistency between this definition of the angle and the definition of
+ * fieldOfView for PerspectiveCamera (where the property value defines the full angle) has
+ * already been noted: https://github.com/IIIF/api/issues/2284
+ *
+ * provisional decision is to return undefined in case that this property
+ * is accessed in a light that is not a spotlight
+ *
+ *
+ * @returns number
+ 
+ **/
+ getAngle(): number | undefined;
+ get Angle(): number | undefined;
+ /**
+ * @return : if not null, is either a PointSelector, or an object
+ * with an id matching the id of an Annotation instance.
+ **/
+ getLookAt(): object | PointSelector | null;
+ get LookAt(): object | null;
 }

dist-commonjs/PointSelector.d.ts

@@ -3,5 +3,12 @@ import { Vector3 } from "threejs-math";
 export declare class PointSelector extends JSONLDResource {
  isPointSelector: boolean;
  constructor(jsonld: any);
+ /**
+ @returns the 3D coordinates of the point as a Vector3 instance.
+ **/
  getLocation(): Vector3;
+ /**
+ @returns the 3D coordinates of the point as a Vector3 instance.
+ **/
+ get Location(): Vector3;
 }

dist-commonjs/SpecificResource.d.ts

@@ -13,6 +13,7 @@ export declare class SpecificResource extends ManifestResource {
  isSpecificResource: boolean;
  constructor(jsonld: any, options?: IManifestoOptions);
  getSource(): object | AnnotationBody;
+ get Source(): object | AnnotationBody;
  getSelector(): PointSelector | null;
  get Selector(): PointSelector | null;
  getTransform(): Transform[];