Camera Keyboard Control

Service that manages keyboard keys and execute camera actions per request. 
Just inject the keyboard control service into any layer, under your ac-map component, And define your keyboard handlers using setKeyboardControls. 
Provided and created by the ac-map component, so each map has it own KeyboardControlService instance.
Simple Example:
Component({
  selector: 'keyboard-control-layer',
  template: '',
})
export class KeyboardControlLayerComponent implements OnInit, OnDestroy {
  constructor(private keyboardControlService: KeyboardControlService) {}
​
  ngOnInit() {
    this.keyboardControlService.setKeyboardControls({
      W: { action: KeyboardAction.CAMERA_FORWARD },
      S: { action: KeyboardAction.CAMERA_BACKWARD },
      D: { action: KeyboardAction.CAMERA_RIGHT },
      A: { action: KeyboardAction.CAMERA_LEFT },
    });
   }
​
  ngOnDestroy() {
    this.keyboardControlService.removeKeyboardControls();
  }
}
Advanced Example:
Component({
  selector: 'keyboard-control-layer',
  template: '',
})
export class KeyboardControlLayerComponent implements OnInit, OnDestroy {
  constructor(private keyboardControlService: KeyboardControlService) {}
​
  private myCustomValue = 10;
​
  ngOnInit() {
    this.keyboardControlService.setKeyboardControls({
      W: {
         action: KeyboardAction.CAMERA_FORWARD,
         validate: (camera, scene, params, key) => {
           // Replace `checkCamera` you with your validation logic
           if (checkCamera(camera) || params.customParams === true) {
             return true;
           }
​
           return false;
         },
         params: () => {
           return {
             myValue: this.myCustomValue,
           };
         },
       }
    });
   }
​
  ngOnDestroy() {
    this.keyboardControlService.removeKeyboardControls();
  }
}
Predefined keyboard actions:
KeyboardAction.CAMERA_FORWARD - Moves the camera forward, accepts a numeric parameter named moveRate that controls
the factor of movement, according to the camera height.
KeyboardAction.CAMERA_BACKWARD - Moves the camera backward, accepts a numeric parameter named moveRate that controls
the factor of movement, according to the camera height.
KeyboardAction.CAMERA_UP - Moves the camera up, accepts a numeric parameter named moveRate that controls
the factor of movement, according to the camera height.
KeyboardAction.CAMERA_DOWN - Moves the camera down, accepts a numeric parameter named moveRate that controls
the factor of movement, according to the camera height.
KeyboardAction.CAMERA_RIGHT - Moves the camera right, accepts a numeric parameter named moveRate that controls
the factor of movement, according to the camera height.
KeyboardAction.CAMERA_LEFT - Moves the camera left, accepts a numeric parameter named moveRate that controls
the factor of movement, according to the camera height.
KeyboardAction.CAMERA_LOOK_RIGHT - Changes the camera to look to the right, accepts a numeric parameter named lookFactor that
controls the factor of looking, according to the camera current position.
KeyboardAction.CAMERA_LOOK_LEFT - Changes the camera to look to the left, accepts a numeric parameter named lookFactor that
controls the factor of looking, according to the camera current position.
KeyboardAction.CAMERA_LOOK_UP - Changes the camera to look up, accepts a numeric parameter named lookFactor that controls
the factor of looking, according to the camera current position.
KeyboardAction.CAMERA_LOOK_DOWN - Changes the camera to look down, accepts a numeric parameter named lookFactor that controls
the factor of looking, according to the camera current position.
KeyboardAction.CAMERA_TWIST_RIGHT - Twists the camera to the right, accepts a numeric parameter named amount that controls
the twist amount
KeyboardAction.CAMERA_TWIST_LEFT - Twists the camera to the left, accepts a numeric parameter named amount that controls
the twist amount
KeyboardAction.CAMERA_ROTATE_RIGHT - Rotates the camera to the right, accepts a numeric parameter named angle that controls
the rotation angle
KeyboardAction.CAMERA_ROTATE_LEFT - Rotates the camera to the left, accepts a numeric parameter named angle that controls
the rotation angle
KeyboardAction.CAMERA_ROTATE_UP - Rotates the camera upwards, accepts a numeric parameter named angle that controls
the rotation angle
KeyboardAction.CAMERA_ROTATE_DOWN - Rotates the camera downwards, accepts a numeric parameter named angle that controls
the rotation angle
KeyboardAction.CAMERA_ZOOM_IN - Zoom in into the current camera center position, accepts a numeric parameter named
amount that controls the amount of zoom in meters.
KeyboardAction.CAMERA_ZOOM_OUT -  Zoom out from the current camera center position, accepts a numeric parameter named
amount that controls the amount of zoom in meters.

GUIDES - Previous

Camera Control

Next - GUIDES

Viewer Configuration

Last modified 2yr ago

Copy link

Outline

Simple Example:

Advanced Example: