Assets
Camera Setup
La "Camera" rappresenta il punto di vista sulla scena 3d, è un oggetto già creato in Hedera in fase di inizializzazione e vi si accede tramite una serei di metodi che ne definiscono eventi e caratteristiche. I "punti di vista" supportati sono due: orbitale rispetto ad un punto "target" e in "prima persona".
Orientamento assi principali
Hedera è conforme alle impostazioni date dallo standard OpenGL.
Impostazione proiezione prospettica
- fildOfView: l'angolo del campo visivo- nearPlane | farPlane: descrivono lo spazio da visualizzare contenunto tra i due parametri che definiscono rispettivamente la distanza minima e massima dalla camera
Viene definita solo la modalità di ripresa della scena, non la posizione ne il movimento della camera. La camera di default viene quindi creata al centro degli assi, pertanto è posssibile che oggetti sovrapposti alla camera sull'origine non vengano "ripresi".
First person view
La camera riprende i movimenti di una ripresa in soggettiva seguendo l'approccio "Aircraft principal axes", in cuil la rotazione in tre dimensioni è data dall'interazione dei tre assi denominati: "yaw", "pitch" e "roll".
Aggiorna la rotazione della camera
Imposta la posizione della camera Sposta la camera in avanti o in dietro rispetto alla direzione di osservazione Sposta la camera a destra o a sinsitra rispetto alla direzione di osservazione Sposta la camera a in alto o in basso rispetto alla direzione di osservazioneOrbit view
La camera si muove seguendo coordinate sferiche attorno ad un oggeto "target".
- lat long: spostano la camera sull'orbita attorno al punto dato
- speed: se animata imposta la velocità di rotazione
Get axis
restituisce l'angolo di rotazione attorno all'asse x
restituisce l'angolo di rotazione attorno all'asse yrestituisce l'angolo di rotazione attorno all'asse z
Entity
- name: prende una stringa come parametro formale e restituisce l'oggetto entity riferito al nome. Restituisce true o false in base all'esito della ricerca Aggiunge un oggetto "entity" alla coda di rendering per essere disegnato. In caso di una scena descritta a partire da un file ".glb", tutti gli oggetti persenti nel file verranno automaticamente aggiunti alla coda di rendering. Rimuove un oggetto "entity" alla coda di rendering per essere disegnato. Naturalmente l'oggetto non verrà eliminato dalla scena, potrà esssere reso visibile in qualisasi momento aggiungendolo nuovamente alla coda di rendering.Transform
position
Modifica la posizione di un oggetto sommando alle sue coordinate i parametri x,y,z. Imposta la posizione di un oggetto. Imposta la posizione di un oggetto in coordinate sferiche attorno al centro degli assi della scena. Imposta la posizione di un oggetto in coordinate sferiche attorno ad un punto °"target".rotation
Modifica la rotazione di un oggetto combinando i valori (gradi) dei parametri formali.
Imposta la rotazione. Modifica la rotazione di un oggetto, mantenendolo sempre perpendicolare al punto di vista.scale
Modifica la scala di un oggetto moltiplicando le sue dimensioni per i parametri x,y,z. Imposta la scala di un oggettoorientation
Restituisce l'angolo tra il punto di vista e un oggetto entity.HederaJS.world.getEntiyEntityAngleRad(entity, entity)
HederaJS.world.getEntiyEntityAngleDeg(entity, entity)
Selection
By color id
Basta effettuare la chiamata una sola volta in fase di inizializzazione della scena corrente. Questo sistema userà un "color id" assegnato a tutti gli ementi inseriti nella coda di rendering per disegnare su un secondo livello non visibile a schermo. In risposta ad un evento verrà catturato il colore sottostane il punto su schermo selezionato.
Disegna ed effettua il controllo su un solo oggetto "entity", ritorna "0" o "1" in base all'esito del confronto tra il "color-id" e il colore associato alla selezione.
entity: indica l'oggetto "entity" da associare alla selezione. x, y: la posizione corrente del mouse o di una "gesture".
Disegna tutta la scena e restitusice un oggetto "entity". Quest'utlimo sarà vuoto se la ricerca avrà esito negativo. x, y: la posizione corrente del mouse o di una "gesture".Render Components
3DEra supporta la descrizione dei materiali PBR (Physically Based Rendering), seguendo le spedifiche gltf
Nella maggior parte delle funzioni viene chiesto di specificare il parametro formale "primitiveIndex". Questo parametro si riferisce al fatto che un oggetto entity può riferisi ad un modllo 3d complesso composto da più geometrie (primiitve), ognuno con un prorio materiale.