ShatteredSword/src/Wolfie2D/Nodes/GameNode.ts

391 lines
10 KiB
TypeScript
Raw Normal View History

import Vec2 from "../DataTypes/Vec2";
import Receiver from "../Events/Receiver";
import Emitter from "../Events/Emitter";
2020-09-06 18:07:09 -04:00
import Scene from "../Scene/Scene";
2020-09-05 00:04:14 -04:00
import Layer from "../Scene/Layer";
import AI from "../DataTypes/Interfaces/AI";
import Physical from "../DataTypes/Interfaces/Physical";
import Positioned from "../DataTypes/Interfaces/Positioned";
import { isRegion } from "../DataTypes/Interfaces/Region";
import Unique from "../DataTypes/Interfaces/Unique";
import Updateable from "../DataTypes/Interfaces/Updateable";
import DebugRenderable from "../DataTypes/Interfaces/DebugRenderable";
import Actor from "../DataTypes/Interfaces/Actor";
2020-10-25 17:46:43 -04:00
import Shape from "../DataTypes/Shapes/Shape";
import Map from "../DataTypes/Map";
import AABB from "../DataTypes/Shapes/AABB";
import NavigationPath from "../Pathfinding/NavigationPath";
2020-11-29 19:49:04 -05:00
import TweenManager from "../Rendering/Animations/TweenManager";
2020-12-21 12:32:32 -05:00
import Debug from "../Debug/Debug";
import Color from "../Utils/Color";
import Circle from "../DataTypes/Shapes/Circle";
2020-09-13 20:57:28 -04:00
/**
* The representation of an object in the game world.
* To construct GameNodes, see the @reference[Scene] documentation.
2020-09-13 20:57:28 -04:00
*/
2020-12-21 12:32:32 -05:00
export default abstract class GameNode implements Positioned, Unique, Updateable, Physical, Actor, DebugRenderable {
2020-10-25 17:46:43 -04:00
/*---------- POSITIONED ----------*/
private _position: Vec2;
2020-10-25 17:46:43 -04:00
/*---------- UNIQUE ----------*/
private _id: number;
/*---------- PHYSICAL ----------*/
hasPhysics: boolean = false;
moving: boolean = false;
onGround: boolean = false;
onWall: boolean = false;
onCeiling: boolean = false;
active: boolean = false;
2020-10-25 17:46:43 -04:00
collisionShape: Shape;
2020-12-22 13:18:10 -05:00
colliderOffset: Vec2;
2020-10-25 17:46:43 -04:00
isStatic: boolean;
isCollidable: boolean;
isTrigger: boolean;
group: string;
triggers: Map<string>;
_velocity: Vec2;
sweptRect: AABB;
collidedWithTilemap: boolean;
physicsLayer: number;
isPlayer: boolean;
2020-12-22 13:18:10 -05:00
isColliding: boolean = false;
2020-10-25 17:46:43 -04:00
/*---------- ACTOR ----------*/
_ai: AI;
aiActive: boolean;
actorId: number;
path: NavigationPath;
pathfinding: boolean = false;
2020-11-29 19:49:04 -05:00
/*---------- GENERAL ----------*/
/** An event receiver. */
protected receiver: Receiver;
/** An event emitter. */
protected emitter: Emitter;
/** A reference to the scene this GameNode is a part of. */
2020-09-06 18:07:09 -04:00
protected scene: Scene;
/** The visual layer this GameNode resides in. */
2020-09-06 18:07:09 -04:00
protected layer: Layer;
/** A utility that allows the use of tweens on this GameNode */
2020-11-29 19:49:04 -05:00
tweens: TweenManager;
/** A tweenable property for rotation. Does not affect the bounding box of this GameNode - Only rendering. */
2020-11-29 19:49:04 -05:00
rotation: number;
/** The opacity value of this GameNode */
2020-12-01 14:04:24 -05:00
alpha: number;
// Constructor docs are ignored, as the user should NOT create new GameNodes with a raw constructor
constructor(){
this._position = new Vec2(0, 0);
2020-11-18 10:57:55 -05:00
this._position.setOnChange(() => this.positionChanged());
this.receiver = new Receiver();
this.emitter = new Emitter();
2020-11-29 19:49:04 -05:00
this.tweens = new TweenManager(this);
this.rotation = 0;
2020-12-01 14:04:24 -05:00
this.alpha = 1;
}
2020-08-17 20:09:41 -04:00
2020-10-25 17:46:43 -04:00
/*---------- POSITIONED ----------*/
get position(): Vec2 {
return this._position;
}
set position(pos: Vec2) {
this._position = pos;
2020-11-18 10:57:55 -05:00
this._position.setOnChange(() => this.positionChanged());
this.positionChanged();
}
2020-12-21 12:32:32 -05:00
get relativePosition(): Vec2 {
return this.inRelativeCoordinates(this.position);
}
/**
* Converts a point to coordinates relative to the zoom and origin of this node
* @param point The point to conver
* @returns A new Vec2 representing the point in relative coordinates
*/
inRelativeCoordinates(point: Vec2): Vec2 {
2020-12-21 12:32:32 -05:00
let origin = this.scene.getViewTranslation(this);
let zoom = this.scene.getViewScale();
return point.clone().sub(origin).scale(zoom);
2020-12-21 12:32:32 -05:00
}
2020-10-25 17:46:43 -04:00
/*---------- UNIQUE ----------*/
get id(): number {
return this._id;
}
set id(id: number) {
// id can only be set once
if(this._id === undefined){
this._id = id;
} else {
throw "Attempted to assign id to object that already has id."
}
}
/*---------- PHYSICAL ----------*/
// @implemented
2020-10-25 17:46:43 -04:00
/**
* @param velocity The velocity with which to move the object.
*/
move(velocity: Vec2): void {
2020-10-25 17:46:43 -04:00
this.moving = true;
this._velocity = velocity;
};
moveOnPath(speed: number, path: NavigationPath): void {
this.path = path;
let dir = path.getMoveDirection(this);
this.moving = true;
this.pathfinding = true;
this._velocity = dir.scale(speed);
}
// @implemented
2020-10-25 17:46:43 -04:00
/**
* @param velocity The velocity with which the object will move.
*/
finishMove(): void {
2020-10-25 17:46:43 -04:00
this.moving = false;
this.position.add(this._velocity);
if(this.pathfinding){
this.path.handlePathProgress(this);
this.path = null;
this.pathfinding = false;
}
}
// @implemented
2020-10-25 17:46:43 -04:00
/**
* @param collisionShape The collider for this object. If this has a region (implements Region),
* it will be used when no collision shape is specified (or if collision shape is null).
* @param isCollidable Whether this is collidable or not. True by default.
* @param isStatic Whether this is static or not. False by default
*/
addPhysics(collisionShape?: Shape, colliderOffset?: Vec2, isCollidable: boolean = true, isStatic: boolean = false): void {
// Initialize the physics variables
2020-10-25 17:46:43 -04:00
this.hasPhysics = true;
this.moving = false;
this.onGround = false;
this.onWall = false;
this.onCeiling = false;
2020-10-25 17:46:43 -04:00
this.active = true;
this.isCollidable = isCollidable;
this.isStatic = isStatic;
this.isTrigger = false;
this.group = "";
this.triggers = new Map();
this._velocity = Vec2.ZERO;
this.sweptRect = new AABB();
this.collidedWithTilemap = false;
this.physicsLayer = -1;
2020-10-25 17:46:43 -04:00
// Set the collision shape if provided, or simply use the the region if there is one.
2020-10-25 17:46:43 -04:00
if(collisionShape){
this.collisionShape = collisionShape;
2021-02-15 19:44:47 -05:00
this.collisionShape.center = this.position;
2020-10-25 17:46:43 -04:00
} else if (isRegion(this)) {
// If the gamenode has a region and no other is specified, use that
this.collisionShape = (<any>this).boundary.clone();
} else {
2020-10-25 17:46:43 -04:00
throw "No collision shape specified for physics object."
}
2020-10-25 17:46:43 -04:00
// If we were provided with a collider offset, set it. Otherwise there is no offset, so use the zero vector
2020-12-22 13:18:10 -05:00
if(colliderOffset){
this.colliderOffset = colliderOffset;
} else {
this.colliderOffset = Vec2.ZERO;
}
// Initialize the swept rect
2020-10-25 17:46:43 -04:00
this.sweptRect = this.collisionShape.getBoundingRect();
// Register the object with physics
2020-10-25 17:46:43 -04:00
this.scene.getPhysicsManager().registerObject(this);
}
/**
* Sets the collider for this GameNode
* @param collider The new collider to use
*/
setCollisionShape(collider: Shape): void {
this.collisionShape = collider;
this.collisionShape.center.copy(this.position);
}
// @implemented
2020-10-25 17:46:43 -04:00
/**
* @param group The name of the group that will activate the trigger
* @param eventType The type of this event to send when this trigger is activated
*/
addTrigger(group: string, eventType: string): void {
2020-10-25 17:46:43 -04:00
this.isTrigger = true;
this.triggers.add(group, eventType);
};
// @implemented
/**
* @param layer The physics layer this node should belong to
*/
setPhysicsLayer(layer: string): void {
this.scene.getPhysicsManager().setLayer(this, layer);
}
// @implemened
2020-12-22 13:18:10 -05:00
getLastVelocity(): Vec2 {
return this._velocity;
}
/*---------- ACTOR ----------*/
get ai(): AI {
return this._ai;
}
set ai(ai: AI) {
if(!this._ai){
// If we haven't been previously had an ai, register us with the ai manager
this.scene.getAIManager().registerActor(this);
}
this._ai = ai;
this.aiActive = true;
}
// @implemented
addAI<T extends AI>(ai: string | (new () => T), options?: Record<string, any>): void {
if(!this._ai){
this.scene.getAIManager().registerActor(this);
}
if(typeof ai === "string"){
this._ai = this.scene.getAIManager().generateAI(ai);
} else {
this._ai = new ai();
}
this._ai.initializeAI(this, options);
this.aiActive = true;
}
// @implemented
setAIActive(active: boolean, options: Record<string, any>): void {
this.aiActive = active;
if(this.aiActive){
this.ai.activate(options);
}
}
2020-11-29 19:49:04 -05:00
/*---------- TWEENABLE PROPERTIES ----------*/
set positionX(value: number) {
this.position.x = value;
}
set positionY(value: number) {
this.position.y = value;
}
abstract set scaleX(value: number);
abstract set scaleY(value: number);
2020-10-25 17:46:43 -04:00
/*---------- GAME NODE ----------*/
/**
* Sets the scene for this object.
* @param scene The scene this object belongs to.
*/
setScene(scene: Scene): void {
this.scene = scene;
}
/**
* Gets the scene this object is in.
* @returns The scene this object belongs to
*/
2020-10-25 17:46:43 -04:00
getScene(): Scene {
return this.scene;
}
2020-10-25 17:46:43 -04:00
/**
* Sets the layer of this object.
* @param layer The layer this object will be on.
*/
setLayer(layer: Layer): void {
this.layer = layer;
}
/**
* Returns the layer this object is on.
* @returns This layer this object is on.
*/
2020-10-25 17:46:43 -04:00
getLayer(): Layer {
return this.layer;
}
/** Called if the position vector is modified or replaced */
2020-11-18 10:57:55 -05:00
protected positionChanged(): void {
if(this.collisionShape){
if(this.colliderOffset){
this.collisionShape.center = this.position.clone().add(this.colliderOffset);
} else {
this.collisionShape.center = this.position.clone();
}
2020-10-25 17:46:43 -04:00
}
};
/**
* Updates this GameNode
* @param deltaT The timestep of the update.
*/
2020-11-29 19:49:04 -05:00
update(deltaT: number): void {
// Defer event handling to AI.
while(this.receiver.hasNextEvent()){
this._ai.handleEvent(this.receiver.getNextEvent());
}
// Update our tweens
2020-11-29 19:49:04 -05:00
this.tweens.update(deltaT);
}
2020-12-21 12:32:32 -05:00
// @implemented
2020-12-21 12:32:32 -05:00
debugRender(): void {
// Draw the position of this GameNode
Debug.drawPoint(this.relativePosition, Color.BLUE);
2020-12-21 12:32:32 -05:00
// If velocity is not zero, draw a vector for it
if(this._velocity && !this._velocity.isZero()){
Debug.drawRay(this.relativePosition, this._velocity.clone().scaleTo(20).add(this.relativePosition), Color.BLUE);
2020-12-22 13:18:10 -05:00
}
// If this has a collider, draw it
if(this.collisionShape){
let color = this.isColliding ? Color.RED : Color.GREEN;
if(this.isTrigger){
color = Color.MAGENTA;
}
color.a = 0.2;
if(this.collisionShape instanceof AABB){
Debug.drawBox(this.inRelativeCoordinates(this.collisionShape.center), this.collisionShape.halfSize.scaled(this.scene.getViewScale()), true, color);
} else if(this.collisionShape instanceof Circle){
Debug.drawCircle(this.inRelativeCoordinates(this.collisionShape.center), this.collisionShape.hw*this.scene.getViewScale(), true, color);
}
2020-12-21 12:32:32 -05:00
}
}
2020-11-29 19:49:04 -05:00
}
export enum TweenableProperties{
posX = "positionX",
posY = "positionY",
scaleX = "scaleX",
scaleY = "scaleY",
2020-12-01 14:04:24 -05:00
rotation = "rotation",
alpha = "alpha"
}