Haskasu @ CG

Name

Haskasu

Email

Link

https://haskasu.com

OPEN

TWars Map Editor

OPEN

# CG.Base Provide tool kits that helps you fast build an app on Code.Gamelet. Key features include: 1. initialize [pixi.js](#pixi.init) or [three.js](#three.init) environment 1. load and access resources that are imported via Code.Gamelet IDE 1. manage update functions that are called every frame 1. provide debug utilities ## Getting Started Follow the steps below to fast start an app with [PixiJS](#pixi.init) or [three.js](#three.init). We will implement a box2d environment to demo the usage of Base. <a name="pixi.init"></a> ## Start with Pixi.js<a name="pixi.init"></a> ```typescript class App { constructor() { // initialize pixi CG.Base.pixi.initialize(600, 400); CG.Base.pixi.physicsDebugDraw.setActive(true); // make a physics wall var wall = CG.Base.physics.createPhysicsObject('wall', {type: 'static'}); wall.addEdge(new CG.Base.geom.Point(10, 300), new CG.Base.geom.Point(500, 330)); // make a dynamic physics ball var ball = CG.Base.physics.createPhysicsObject('ball', {type: 'dynamic'}); ball.addCircle(0, 0, 10, {friction: 0.1, density: 0.1, restitution: 0.3}); ball.setPosition(100, 10); } } new App(); ``` @see [Demo](/edit/Base_Start_with_PIXI) ## Load and play with Resources To load resources that are imported from IDE: ```typescript // tell resources what resources to load (using the alias names) CG.Base.resourceManager.addAppResource('Game1.button'); CG.Base.resourceManager.addAppResource('Game1.music'); // start loading CG.Base.resourceManager.load(() => { // all loaded callback // create button with the image "Game1.button" alias name var button = new CG.Base.pixis.interactive.Button(CG.Base.resourceManager.createPixiSprite('Game1.button', 20, 20)); // set the position of the button button.displayObject.position.set(100, 100); // add the button to pixi.root, so pixi can render the button CG.Base.pixi.root.addChild(button.displayObject); // add a click event listener button.on(CG.Base.pixis.interactive.Button.EVENT.CLICK, () => { // when the button is clicked, play sound with "Game1.music" alias name CG.Base.resourceManager.playSound('Game1.music') }); }); ``` @see [Demo](/edit/Base_Load_Resources) ## Manage update functions Take advantage of CG.Base.addUpdateFunction to make a function called every frame ```typescript class App { constructor() { CG.Base.pixi.initialize(600, 400); CG.Base.addUpdateFunction(this, this.update); } // this function will be called every frame(called 60 times per second normally) private update(deltaTime:number):void { // do something } } new App(); ``` @see [Demo](/edit/Base_Update_and_Delay_Func) You can call a function in the future by CG.Base.addDelayFunction ```typescript class App { constructor() { CG.Base.pixi.initialize(600, 400); // call this.delayAction in 1000 milliseconds(= one second) CG.Base.addDelayFunction(this, this.delayAction, 1000); } private delayAction():void { // do something } } new App(); ``` @see [Demo](/edit/Base_Update_and_Delay_Func) ## Interact with Keyboard Use CG.Base.keyboard package to interact with keyboard events. ```typescript export class App { constructor() { // make the window focused, so we can receive keyboard events. window.focus(); // initialize pixi CG.Base.pixi.initialize(600, 400); // tell resourceManager to load the resource 'Game1.button' CG.Base.resourceManager.addAppResource('Game1.button'); // load resources, and wait callback when resources are all loaded CG.Base.resourceManager.load(() => { // add keyboard event listener, when a key is pressed CG.Base.keyboardManager.on(CG.Base.keyboard.KeyboardManagerEvent.PRESSED, key => { // if the pressed key is space, we call this.createSprite() if (key == CG.Base.keyboard.Key.SPACE) { this.createSprite(); } }); }); } private createSprite(): void { // create a sprite with the image 'Game1.button' var sprite: PIXI.Sprite = CG.Base.resourceManager.createPixiSprite('Game1.button'); // set the position of the sprite sprite.position.set(CG.Base.utils.IntUtil.randomBetween(100, 500), CG.Base.utils.IntUtil.randomBetween(100, 300)); // add the sprite to pixi.root, so it can be rendered CG.Base.pixi.root.addChild(sprite); } } new App(); ``` @see [Demo](/edit/Base_PIXI_Keyboard) ## Debugging The best debug tool on browser is the [developer tools](https://developer.chrome.com/devtools) in Chrome (F12). To find your source code in developer tools, first open developer tools(F12), click "Sources" tab, and search the Network tree as below: > top => {projectCode} => gameFrame => code.gamelet.com => gassets => file/{projectCode}/src for example, if the projectCode is 'Game1', source code is located at > top => Game1 => gameFrame => code.gamelet.com => gassets => file/Game1/src ![Source Network Tree](https://code.gamelet.com/gassets/asset/Base/Base.networktree/networktree.png "Source Network Tree") ### Add Watch In addition to browser's debugging tools, CG.Base provides other useful tools. CG.Base.addWatch() adds objects or objects' properties to Watch panel in CG IDE. ```typescript export class App { constructor() { // initialize pixi CG.Base.pixi.initialize(600, 400); // tell resourceManager to load the resource 'Game1.button' CG.Base.resourceManager.addAppResource('Game1.button'); CG.Base.resourceManager.load(() => { // add the created sprite into Watch panel, the alias name in Watch panel is 'sprite' CG.Base.addWatch('sprite', this.createSprite()); }); // add this(App)'s 'time' property into Watch panel. The alias name for this property is 'now' CG.Base.addWatch('now', this, 'time'); } private createSprite(): PIXI.Sprite { // create a sprite with the image 'Game1.button' var sprite: PIXI.Sprite = CG.Base.resourceManager.createPixiSprite('Game1.button'); // set the position of the sprite sprite.position.set(CG.Base.utils.IntUtil.randomBetween(100, 500), CG.Base.utils.IntUtil.randomBetween(100, 300)); // add the sprite to pixi.root, so it can be rendered CG.Base.pixi.root.addChild(sprite); return sprite; } // a getter function, that works like a property of App object. get time(): number { return CG.Base.time(); } } new App(); ``` @see [Demo](/edit/Base_Add_Watch) ## Versioning We use [SemVer](http://semver.org/) for versioning. ## Links and Resources This library is running with the libraries below. * [Pixi.js](http://www.pixijs.com/) - 2D rendering engine * [API reference](http://pixijs.download/release/docs/index.html) * [Examples](http://pixijs.io/examples/) * [Three.js](https://threejs.org/) - 3D rendering engine * [API & Docs](https://threejs.org/docs/index.html#manual/introduction/Creating-a-scene) * [Examples](https://threejs.org/examples/) * [Pixi keyboard](https://github.com/Nazariglez/pixi-keyboard) - Keyboard utility * [Pixi sound](https://github.com/pixijs/pixi-sound) - Sound utility * [Pixi filters](https://github.com/pixijs/pixi-filters) - Filters Collections * [Pixi GafPlayer](https://github.com/mathieuanthoine/PixiGAFPlayer) - [GafMedia](https://gafmedia.com/) Player * [Liquidfun](http://google.github.io/liquidfun/) - Box2D based physics engine * [MD5](http://www.myersdaily.org/joseph/javascript/md5-text.html) - MD5 implementation by Joseph Myers ## Authors **Haska Su** - *Initial work*

OPEN

TwilightWarsEvents

OPEN

OPEN

OPEN

OPEN

無差別五子棋

OPEN

OPEN

OPEN

COVID-19 Command Center

OPEN

光暈測試機

OPEN

OPEN

OPEN

OPEN

OPEN

# TiledMapEngine 方塊地圖遊戲引擎如果大家有玩過光暈戰記／Minecraft，那一定方塊地圖十分了解：<br/> #### <I>方塊地圖是指地圖由一格一格組成。</I><br/> 這個引擎可以讓大家輕鬆做出方塊地圖，並在地圖上設計遊戲。<br/> 不過使用這個引擎之前，你必須在<a href="">我們提供的地圖編輯器</a>設計你的地圖。<br/> 有關地圖編輯器的說明，可以在該專案查看。<br/><br/> ## 我不懂那些函式怎用，怎麼辨？你可以點入本專案程式碼查看說明，一切程式碼都是開源的。<br/> 你也可以在本專案建立討論串，說明你的問題。<br/> ## How to use 本專案大多使用asynchronous function，<br/> 換而言之，在使用本專案之前，你可能需要學習一些語法，比如： ```typescript this.gameMap.renderMap() .then(() => { //write your code in here }); ``` 這個程式是要this.gameMap去加載地圖，由於加載地圖需要時間，<br/> 不使用asynchronous function的話，你的程式會卡著一段時間。<br/> 現在，在使用asynchronous function的設計後，你只要把加載地圖之後的程式寫在then中，就可以避免卡著的情況。<br/><br/> 在完成地圖設計之後，你會得一個JSON檔案，這個檔案儲存了一切有關那個的資料。<br/> 然後，你須在你的專案加入本模組，並把JSON檔案上載至你的專案（你也可以修改左方CG.TiledMapEngine中的tiled_map.json）。<br/> 接下來，請參考加載地圖示範： ```typescript CG.Base.pixi.initialize(500, 600); //格式化PIXI CG.Base.resourceManager.addAppResource('TiledMapEngine.mapResource') //加載你的地圖圖片 CG.Base.resourceManager.load(() => { //step 1: 加載JSON $.getJSON(CG.Base.getAppSourceUrl('CG.TiledMapEngine/tiled_map.json'), (data) => { //請把那個url改成你json檔案位置，如果你是直接修改tiled_map.json，這邊可以不用改 //step 2:建立地圖，並把地圖資料，即JSON傳入 this.gameMap = new CG.TiledMapEngine.Map(data , true); //建立一張新地圖，在建立時，會把json資料傳入, true代表有視野限制 //step 3:把地圖素材包加到地圖中 this.gameMap.importUsedMapTexture() //把地圖格子資料加到地圖 .then(() => { //step 4:生成地圖 this.gameMap.renderMap() //生成地圖 .then(() => { CG.Base.pixi.root.addChild(this.gameMap); //把地圖加到PIXI中 }); }); }) }); ``` 這樣，你就會得一個this.gameMap，而這就是你的地圖。<br/> 在CG中，實作無限地圖十分簡單，<br/> 在光暈，我們只有一個地圖，即是只有一個this.gameMap，<br/> 但在CG，你可以使用上面的方法，建立多個地圖。 ## API ### CG.TiledMapEngine.camera ### <div style="color:red">Method</div> set(map: Map, x: number, y: number): void<br/> 根據輸入的地圖和位置，移動視角。 | Parameter | Type | Description | Optional | |:---------:|:------:|:------------------:|:--------:| | map | Map | 要移動視角的地圖。 | No | | x | number | 位置的x軸座標。 | No | | y | number | 位置的y軸座標。 | No | ## Author **[gamtable](/profile/gamtable)**

方塊地圖遊戲引擎

OPEN

OPEN

TutConnections2

OPEN

OPEN

ⒸCode.Gamelet.com | Privacy Policy | Terms of Service