module TS.SpaceTac.UI { export type IBounded = { x: number y: number width: number height: number } // Common UI tools functions export class UITools { /** * Get the position of an object, adjusted to remain inside a container */ static positionInside(obj: IBounded, container: IBounded): [number, number] { let y = obj.y; if (y + obj.height > container.height) { y = container.height - obj.height; } if (y < container.y) { y = container.y; } let x = obj.x; if (x + obj.width > container.width) { x = container.width - obj.width; } if (x < container.x) { x = container.x; } return [x, y]; } /** * Reposition an object to remain inside a container */ static keepInside(obj: Phaser.Button | Phaser.Sprite | Phaser.Image | Phaser.Group | Phaser.Graphics, rect: IBounded) { let objbounds = obj.getBounds(); let [x, y] = UITools.positionInside({ x: obj.x, y: obj.y, width: objbounds.width, height: objbounds.height }, rect); if (x != obj.x || y != obj.y) { obj.position.set(x, y); } } /** * Setup a hover/hold/click routine on an object * * This should span the bridge between desktop and mobile targets. */ static setHoverClick(obj: Phaser.Button, enter: Function, leave: Function, click: Function, hovertime = 300, holdtime = 600) { let holdstart = new Date(); let enternext: Function | null = null; let entercalled = false; let cursorinside = false; obj.input.useHandCursor = true; let prevententer = () => { if (enternext != null) { Timer.global.cancel(enternext); enternext = null; return true; } else { return false; } }; let effectiveenter = () => { enternext = null; entercalled = true; enter(); } let effectiveleave = () => { prevententer(); if (entercalled) { entercalled = false; leave(); } } if (obj.events) { obj.events.onDestroy.addOnce(() => { prevententer(); }); } obj.onInputOver.add(() => { cursorinside = true; enternext = Timer.global.schedule(hovertime, effectiveenter); }); obj.onInputOut.add(() => { cursorinside = false; effectiveleave(); }); obj.onInputDown.add(() => { holdstart = new Date(); if (!cursorinside && !enternext) { enternext = Timer.global.schedule(holdtime, effectiveenter); } }); obj.onInputUp.add(() => { if (!cursorinside) { effectiveleave(); } if (new Date().getTime() - holdstart.getTime() < holdtime) { if (!cursorinside) { effectiveenter(); } click(); if (!cursorinside) { effectiveleave(); } } }); } // Constraint an angle in radians the ]-pi;pi] range. static normalizeAngle(angle: number): number { angle = angle % (2 * Math.PI); if (angle <= -Math.PI) { return angle + 2 * Math.PI; } else if (angle > Math.PI) { return angle - 2 * Math.PI; } else { return angle; } } /** * Evenly space identical items in a parent * * Returns the relative position of item's center inside parent_width */ static evenlySpace(parent_width: number, item_width: number, item_count: number): number[] { if (item_width * item_count <= parent_width) { let spacing = parent_width / item_count; return range(item_count).map(i => (i + 0.5) * spacing); } else { let breadth = parent_width - item_width; let spacing = breadth / (item_count - 1); return range(item_count).map(i => item_width / 2 + i * spacing); } } } }