Bildziel Ereignisse

Typen

ImagePropertiesObject

ImagePropertiesObject" ist ein Objekt mit den folgenden Eigenschaften:

Eigentum	Typ	Beschreibung
Breite	Nummer	Breite des Zielbildes.
Höhe	Nummer	Höhe des Zielbildes.
originalBreite	Nummer	Breite des hochgeladenen Bildes.
originalHöhe	Nummer	Höhe des hochgeladenen Bildes.
isRotated	boolesche	Ob das Bildziel gedreht wurde.

ImageLoadingObject

ImageLoadingObject" ist ein Objekt mit den folgenden Eigenschaften:

Eigentum	Typ	Beschreibung
name	Zeichenfolge	Der Name des Bildes.
typ	String	Eines von FLAT, CYLINDRICAL, CONICAL.
Metadaten	Objekt	Benutzer-Metadaten.

ImageScanningObject

ImageScanningObject" ist ein Objekt mit den folgenden Eigenschaften:

Eigentum	Typ	Beschreibung
name	String	Der Name des Bildes.
Typ	String	Eines von FLAT, CYLINDRICAL, CONICAL.
Metadaten	Objekt	Benutzer-Metadaten.
Geometrie	Objekt	Objekt mit Geometriedaten. Wenn type=FLAT:{scaledWidth, scaledHeight}, sonst bei type=CYLINDRICAL oder type=CONICAL: {height, radiusTop, radiusBottom, arcStartRadians, arcLengthRadians}

Veranstaltungen

REALITÄTS_BILD_GEFUNDEN

Dieses Ereignis wird ausgelöst, wenn ein Bildziel zum ersten Mal gefunden wird.

Eigenschaft

Eigenschaft	Typ	Beschreibung
Name	String	Der Name des Bildes.
Typ	Zeichenfolge	Eines von FLAT, CYLINDRICAL, CONICAL.
Position	{x, y, z}	Die 3d-Position des georteten Bildes.
Rotation	{w, x, y, z}	Die lokale 3D-Ausrichtung des georteten Bildes.
Skala	Nummer	Ein Skalierungsfaktor, der auf das an dieses Bild angehängte Objekt angewendet werden soll.
Eigenschaften	ImagePropertiesObject	Zusätzliche Bildzieleigenschaften.
scaledWidth	Nummer	Nur anwendbar auf FLAT. Die Breite des Bildes in der Szene, multipliziert mit dem Maßstab.
scaledHeight	Nummer	Nur anwendbar auf FLAT. Die Höhe des Bildes in der Szene, wenn sie mit dem Maßstab multipliziert wird.
Höhe	Nummer	Nur anwendbar auf CYLINDRICAL oder CONICAL. Höhe der gekrümmten Zielscheibe.
radiusTop	Nummer	Nur anwendbar auf CYLINDRICAL oder CONICAL. Radius der gekrümmten Zielscheibe am oberen Rand.
radiusBottom	Nummer	Nur anwendbar auf CYLINDRICAL oder CONICAL. Radius der gekrümmten Zielscheibe am unteren Rand.
arcStartRadian	Nummer	Nur anwendbar auf CYLINDRICAL oder CONICAL. Startwinkel in Radiant.
arcLengthRadians	Nummer	Nur anwendbar auf CYLINDRICAL oder CONICAL. Zentralwinkel in Radiant.

Beispiel

• .listen
• .onEvent
• .addEventListener

defineState('initial-state').initial().listen(world.events.globalId, ecs.events.REALITY_IMAGE_FOUND, (event) => {
  console.log('Image found: ', event.data.name)
})

REALITÄT_BILD_LADEN

Dieses Ereignis wird ausgelöst, wenn das Laden des Erkennungsbildes beginnt.

Eigenschaften

Eigenschaft	Typ	Beschreibung
imageTargets	Array<ImageLoadingObject>	Die Liste der Bildziele.

Beispiel

• .listen
• .onEvent
• .addEventListener

defineState('initial-state').initial().listen(world.events.globalId, ecs.events.REALITY_IMAGE_LOADING, (event) => {
  event.data.imageTargets.forEach(({name, type, metadata, geometry}) => {
    console.log('Loading: ', name)
  })
})

REALITY_IMAGE_LOST

Dieses Ereignis wird ausgelöst, wenn ein Bildziel nicht mehr verfolgt wird.

Eigenschaften

Eigentum	Typ	Beschreibung
name	String	Der Name des Bildes.
Typ	String	Eines von FLAT, CYLINDRICAL, CONICAL.
Position	{x, y, z}	Die 3d-Position des georteten Bildes.
Rotation	{w, x, y, z}	Die lokale 3D-Ausrichtung des georteten Bildes.
Skala	Nummer	Ein Skalierungsfaktor, der auf das an dieses Bild angehängte Objekt angewendet werden soll.
eigenschaften	ImagePropertiesObject	Zusätzliche Bildzieleigenschaften.
scaledWidth	Nummer	Nur anwendbar auf FLAT. Die Breite des Bildes in der Szene, multipliziert mit dem Maßstab.
scaledHeight	Nummer	Nur anwendbar auf FLAT. Die Höhe des Bildes in der Szene, wenn sie mit dem Maßstab multipliziert wird.
Höhe	Nummer	Nur anwendbar auf CYLINDRICAL oder CONICAL. Höhe der gekrümmten Zielscheibe.
radiusTop	Nummer	Nur anwendbar auf CYLINDRICAL oder CONICAL. Radius der gekrümmten Zielscheibe am oberen Rand.
radiusBottom	Nummer	Nur anwendbar auf CYLINDRICAL oder CONICAL. Radius der gekrümmten Zielscheibe am unteren Rand.
arcStartRadian	Nummer	Nur anwendbar auf CYLINDRICAL oder CONICAL. Startwinkel in Radiant.
arcLengthRadians	Nummer	Nur anwendbar auf CYLINDRICAL oder CONICAL. Zentralwinkel in Radiant.

Beispiel

• .listen
• .onEvent
• .addEventListener

defineState('initial-state').initial().listen(world.events.globalId, ecs.events.REALITY_IMAGE_LOST, (event) => {
  console.log('Image lost: ', event.data.name)
})

REALITÄTS_BILD_ABTASTUNG

Dieses Ereignis wird ausgelöst, wenn alle Erkennungsbilder geladen wurden und der Scanvorgang begonnen hat.

Eigenschaften

Eigentum	Typ	Beschreibung
imageTargets	Array<ImageScanningObject>	Die Liste der Bildziele.

Beispiel

• .listen
• .onEvent
• .addEventListener

defineState('initial-state').initial().listen(world.events.globalId, ecs.events.REALITY_IMAGE_SCANNING, (event) => {
  event.data.imageTargets.forEach(({name, type, metadata, geometry}) => {
    console.log('Scanning: ', name)
  })
})

REALITÄTS_BILD_AKTUALISIERT

Dieses Ereignis wird ausgelöst, wenn ein Bildziel seine Position, Drehung oder Skalierung ändert.

Eigenschaften

Eigentum	Typ	Beschreibung
Name	Zeichenfolge	Der Name des Bildes.
Typ	String	Eines von FLAT, CYLINDRICAL, CONICAL.
Position	{x, y, z}	Die 3d-Position des georteten Bildes.
Rotation	{w, x, y, z}	Die lokale 3D-Ausrichtung des georteten Bildes.
Skala	Nummer	Ein Skalierungsfaktor, der auf das an dieses Bild angehängte Objekt angewendet werden soll.
Eigenschaften	ImagePropertiesObject	Zusätzliche Bildzieleigenschaften.
scaledWidth	Nummer	Nur anwendbar auf FLAT. Die Breite des Bildes in der Szene, multipliziert mit dem Maßstab.
scaledHeight	Nummer	Nur anwendbar auf FLAT. Die Höhe des Bildes in der Szene, wenn sie mit dem Maßstab multipliziert wird.
Höhe	Nummer	Nur anwendbar auf CYLINDRICAL oder CONICAL. Höhe der gekrümmten Zielscheibe.
radiusTop	Nummer	Nur anwendbar auf CYLINDRICAL oder CONICAL. Radius der gekrümmten Zielscheibe am oberen Rand.
radiusBottom	Nummer	Nur anwendbar auf CYLINDRICAL oder CONICAL. Radius der gekrümmten Zielscheibe am unteren Rand.
arcStartRadian	Nummer	Nur anwendbar auf CYLINDRICAL oder CONICAL. Startwinkel in Radiant.
arcLengthRadians	Nummer	Nur anwendbar auf CYLINDRICAL oder CONICAL. Zentralwinkel in Radiant.

Beispiel

• .listen
• .onEvent
• .addEventListener

defineState('initial-state').initial().listen(world.events.globalId, ecs.events.REALITY_IMAGE_UPDATED, (event) => {
  console.log('Image updated: ', event.data.position, event.data.rotation)
})