Class ZapparCamera

Zicon

camera

Ztag

three/Object3D/Group/Zappar/Camera

Ztag

three/Object3D/Camera/ZapparCamera

Ztag

three/Object3D/Group/ZapparCamera

Zparents

three/Object3D/Group/Group

Hierarchy

  • Camera<THREE.PerspectiveCamera>
    • ZapparCamera

Accessors

currentMirrorMode disposed elementsResolved lockedResolved

Constructors

constructor

Methods

_updateProjectionMatrix activate addBehavior appendChild constructChildren dispose getBehavior getBehaviors getZComponentInstance register remove removeBehavior removeChild unregister

Other

tags

Properties - Appearance

castShadow receiveShadow visible

Properties - Behavior

enabled

Properties - Camera

cameraDirection far near originAnchor poseMode rearMirrorMode userMirrorMode

Properties - Other

backgroundTexture behaviors children contextManager element enabledResolved isPerspectiveCamera locked? lookAt onClick onDispose onIntersectionEnter onIntersectionLeave onPointerDown onPointerEnter onPointerLeave onPointerMove onPointerUp parent? position rotation scale

Accessors

currentMirrorMode

disposed

  • get disposed(): boolean

  • Gets the disposed status of the entity.

    Returns boolean

    The disposed status.

elementsResolved

  • get elementsResolved(): any[]

  • An array of the elements that this component instance exposes. In the case that this component does not expose any elements of its own, this will be an array of the elements exposed by this component's children.

    Returns any[]

lockedResolved

  • get lockedResolved(): boolean

  • Returns true if this component, or any of its parents, are marked as locked.

    Returns boolean

Constructors

constructor

Methods

_updateProjectionMatrix

activate

  • activate(): void

  • Activates the camera.

    Returns void

    Zprop

addBehavior

  • addBehavior(b): void

  • Adds a behavior to the component.

    Parameters

    • b: Behavior<Component<any, ConstructorProps>>

      The behavior to add.

    Returns void

appendChild

  • appendChild(c): void

  • Parameters

    • c: Component<any, ConstructorProps>

    Returns void

constructChildren

  • constructChildren(children, contextManager?): void

  • Constructs the children of this component.

    Parameters

    • children: ComponentChildren
    • OptionalcontextManager: ContextManager

    Returns void

dispose

getBehavior

  • getBehavior<T>(type): undefined | InstanceType<T>

  • Gets a behavior of a specific type from the component.

    Type Parameters

    • T extends (new (contextManager: ContextManager, instance: Component<any, ConstructorProps>, ...args: any[]) => Behavior<Component<any, ConstructorProps>>)

      The behavior type.

    Parameters

    • type: T

      The type of behavior to get.

    Returns undefined | InstanceType<T>

    The behavior of the specified type, or undefined if no such behavior exists.

getBehaviors

  • getBehaviors<T>(type): InstanceType<T>[]

  • Gets all behaviors of a specific type from the component.

    Type Parameters

    • T extends (new (contextManager: ContextManager, instance: Component<any, ConstructorProps>, ...args: any[]) => Behavior<Component<any, ConstructorProps>>)

      The behavior type.

    Parameters

    • type: T

      The type of behaviors to get.

    Returns InstanceType<T>[]

    An array of behaviors of the specified type.

getZComponentInstance

  • getZComponentInstance<T>(type?): T

  • Get the instance of the ZComponent that constructed this entity.

    If you pass the class of a ZComponent as the type parameter, this function will ensure that it returns an instance of that ZComponent. If this component or behavior was constructed by a different ZComponent class, or by a different entity altogether, the function with throw an error.

    Type Parameters

    • T extends ZComponent<any, T> = ZComponent<any>

    Parameters

    • Optionaltype: ConstructorForComponent<T>

      The ZComponent class that you are expecting to receive

    Returns T

    The instance of the ZComponent that constructed this component or behavior

register

  • register<Args>(evt, fn, priority?): any

  • Register a function to be called when an Event is fired, or an Observable's value changes. The function will only be bound to the underlying Event or Observable while this entity is enabled.

    Using this function, rather than attaching your handler directly to the Event or Observable, ensures your handler is automatically released when this entity is disposed.

    Type Parameters

    • Args extends any[]

    Parameters

    • evt: Event<Args>

      The Event or Observable to listen to

    • fn: ((...args: Args) => void)

      A function that will be called when the event fires, or the Observable value changes

        • (...args): void

        • Parameters

          Returns void

    • Optionalpriority: number

    Returns any

  • register<Args>(evt, fn, options?): any

  • Type Parameters

    • Args extends any[]

    Parameters

    Returns any

  • register<Type>(observable, fn, priority?): any

  • Type Parameters

    • Type

    Parameters

    • observable: Observable<Type, never>
    • fn: ((v: Type) => void)
        • (v): void

        • Parameters

          Returns void

    • Optionalpriority: number

    Returns any

  • register<Type>(observable, fn, options?): any

  • Type Parameters

    • Type

    Parameters

    Returns any

remove

  • remove(): void

  • Removes this component from its parent component.

    Returns void

removeBehavior

  • removeBehavior(b): void

  • Removes a behavior from the component.

    Parameters

    • b: Behavior<Component<any, ConstructorProps>>

      The behavior to remove.

    Returns void

removeChild

  • removeChild(c): void

  • Parameters

    • c: Component<any, ConstructorProps>

    Returns void

unregister

  • unregister<Args>(evt, fn): any

  • Unregisters a function that was previously registered to an Event or Observable.

    Type Parameters

    • Args extends any[]

    Parameters

    • evt: Event<Args>

      The Event or Observable

    • fn: ((...args: Args) => void)

      The function that was passed in the call to register

        • (...args): void

        • Parameters

          Returns void

    Returns any

  • unregister<Type>(observable, fn): any

  • Type Parameters

    • Type

    Parameters

    • observable: Observable<Type, never>
    • fn: ((v: Type) => void)
        • (v): void

        • Parameters

          Returns void

    Returns any

Other

Readonlytags

tags: Observable<string[], never>

An array of string 'tags' assocated with this component.

The getComponentsByTag(mgr, tag) function can be used to get an array of components with the supplied tag.

By default, tags are scoped to the ZComponent instance that a component is constructed by. Tags that begin with global: are scoped to the experience as a whole.

Zprop

Zgrouppriority

0

Properties - Appearance

castShadow

castShadow: Observable<boolean, never>

Determines if this object casts shadows.

Zprop

Zgrouppriority

11

Zdefault

true

receiveShadow

receiveShadow: Observable<boolean, never>

Determines if this object receives shadows.

Zprop

Zgrouppriority

11

Zdefault

true

visible

visible: Observable<boolean, never>

Determines if this object and its children are rendered to the screen.

Zprop

Zgrouppriority

11

Zdefault

true

Properties - Behavior

Readonlyenabled

enabled: Observable<boolean, never>

If false, this entity and its children will no longer participate in the experience.

Note - to read this value, you may wish to use enabledResolved which will be false if this entity, or any of its parents, have enabled set to false.

The precise implications of enabled being false will vary between entities, but in general disabled entities:

  • should not emit any events,
  • should not take any action, e.g. navigate the user to a different page,
  • should not perform any network communication,
  • should not make changes to other behaviors or components in the experience,
  • should minimise any runtime performance cost (e.g. detach from any frame handlers).

Zprop

Zdefault

true

Zgrouppriority

10

Properties - Camera

cameraDirection

cameraDirection: Observable<CameraDirection, never> = ...

Which of rear or user facing cameras to use. This property can be changed at runtime to flip between the cameras.

Zprop

Zgrouppriority

20

Zdefault

none

far

far: Observable<number, never> = ...

The far clipping plane of the camera.

Zprop

Zgrouppriority

21

Zdefault

2000

near

near: Observable<number, never> = ...

The near clipping plane of the camera.

Zprop

Zgrouppriority

21

Zdefault

0.1

originAnchor

originAnchor: Observable<undefined | string, never> = ...

The anchor to use as the origin of the camera's pose when poseMode is set to anchorOrigin.

Zprop

Zgrouppriority

21

Zvalues

nodelabels three/Object3D/Group/Zappar/Anchor

poseMode

poseMode: Observable<CameraPoseMode, never> = ...

Mode for the camera to move around in the ThreeJS scene. The correct choice of camera pose will depend on your given use case and content.

Default

In this mode the camera stays at the origin of the scene, pointing down the negative Z axis. Any tracked anchors will move around in your scene as the user moves the physical camera and real-world tracked objects.

Attitude

The camera stays at the origin of the scene, but rotates as the user rotates the physical device. When the Zappar library initializes, the negative Z axis of world space points forward in front of the user.

AnchorOrigin

In this mode, the origin of the scene is the center of the anchor specified by the camera's originAnchor parameter. The camera moves and rotates in world space around the anchor at the origin. If no originAnchor is specified, the camera will pick an anchor automatically to become the origin of the scene.

Zprop

Zgrouppriority

21

Zdefault

anchorOrigin

rearMirrorMode

rearMirrorMode: Observable<CameraMirrorMode, never> = ...

The mirror mode for the rear-facing camera.

  • Poses: this mode mirrors the background camera texture and ensures content still appears correctly tracked. In this mode your content itself isn't flipped, so any text in your tracked content doesn't appear mirrored. This is the default mode for the user-facing camera.
  • CSS: in this mode, the Zappar camera applies a scaleX(-1) CSS transform to your whole canvas. This way both the camera and your content appear mirrored.
  • None: no mirroring is performed. This is the default mode for the rear-facing camera.

Zprop

Zgrouppriority

21

Zdefault

none

userMirrorMode

userMirrorMode: Observable<CameraMirrorMode, never> = ...
  • The mirror mode for the user-facing camera.
  • Poses: this mode mirrors the background camera texture and ensures content still appears correctly tracked. In this mode your content itself isn't flipped, so any text in your tracked content doesn't appear mirrored. This is the default mode for the user-facing camera.
  • CSS: in this mode, the Zappar camera applies a scaleX(-1) CSS transform to your whole canvas. This way both the camera and your content appear mirrored.
  • None: no mirroring is performed. This is the default mode for the rear-facing camera.

Zprop

Zgrouppriority

21

Zdefault

poses

Properties - Other

backgroundTexture

backgroundTexture: Texture | CameraTexture

Readonlybehaviors

behaviors: Behavior<Component<any, ConstructorProps>>[]

The behaviors attached to this component.

Readonlychildren

children: Component<any, ConstructorProps>[]

The children of this component.

ReadonlycontextManager

contextManager: ContextManager

element

element: PerspectiveCamera

ReadonlyenabledResolved

enabledResolved: Observable<boolean, never>

This will have value false if this entity, or any of its parents, have enabled set to false.

To change the enabled status of this entity, use the enabled property instead.

The precise implications of enabled being false will vary between entities, but in general disabled entities:

  • should not emit any events,
  • should not take any action, e.g. navigate the user to a different page,
  • should not perform any network communication,
  • should not make changes to other behaviors or components in the experience,
  • should minimise any runtime performance cost.

Disabled entities will typically remain visible (if they have a visible appearance).

isPerspectiveCamera

isPerspectiveCamera: boolean = true

Optionallocked

locked?: boolean

If true, this component can't be selected at design time in the 3D preview.

lookAt

lookAt: Observable<undefined | [number, number, number], never>

onClick

onClick: Event<[ThreePointerPresentEvent]>

Zprop

ReadonlyonDispose

onDispose: Event<[]>

An event that is fired as the last act of this entity being destroyed.

onIntersectionEnter

onIntersectionEnter: Event<[IntersectionPresentEvent]>

Zprop

onIntersectionLeave

onIntersectionLeave: Event<[IntersectionEvent]>

Zprop

onPointerDown

onPointerDown: Event<[ThreePointerPresentEvent]>

Zprop

onPointerEnter

onPointerEnter: Event<[ThreePointerPresentEvent]>

Zprop

onPointerLeave

onPointerLeave: Event<[ThreePointerEvent]>

Zprop

onPointerMove

onPointerMove: Event<[ThreePointerPresentEvent]>

Zprop

onPointerUp

onPointerUp: Event<[ThreePointerPresentEvent]>

Zprop

Optionalparent

parent?: Component<any, ConstructorProps>

The parent of this component.

position

position: Observable<[x: number, y: number, z: number], never>

Zignore

rotation

rotation: Observable<[x: number, y: number, z: number], never>

Zignore

scale

scale: Observable<[x: number, y: number, z: number], never>

Zignore

Settings

Member Visibility

On This Page

currentMirrorModedisposedelementsResolvedlockedResolvedconstructor_updateProjectionMatrixactivateaddBehaviorappendChildconstructChildrendisposegetBehaviorgetBehaviorsgetZComponentInstanceregisterremoveremoveBehaviorremoveChildunregistertagscastShadowreceiveShadowvisibleenabledcameraDirectionfarnearoriginAnchorposeModerearMirrorModeuserMirrorModebackgroundTexturebehaviorschildrencontextManagerelementenabledResolvedisPerspectiveCameralockedlookAtonClickonDisposeonIntersectionEnteronIntersectionLeaveonPointerDownonPointerEnteronPointerLeaveonPointerMoveonPointerUpparentpositionrotationscale