[ { "path": "LICENSE", "content": "# nimgame2\n# Copyright (c) 2016-2020 Vladimir Arabadzhi (Vladar)\n#\n# Permission is hereby granted, free of charge, to any person obtaining a copy\n# of this software and associated documentation files (the \"Software\"), to deal\n# in the Software without restriction, including without limitation the rights\n# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n# copies of the Software, and to permit persons to whom the Software is\n# furnished to do so, subject to the following conditions:\n#\n# The above copyright notice and this permission notice shall be included in\n# all copies or substantial portions of the Software.\n#\n# THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\n# THE SOFTWARE.\n#\n# vladar4@gmail.com\n# https://github.com/Vladar4\n\n" }, { "path": "README.md", "content": "Nimgame 2\n=========\n\nA simple 2D game engine for Nim language.\n\nFor more information check [home page](https://vladar4.github.io/nimgame2/).\n\n[Coding style guide](STYLE.md) for the contributors.\n\nAll pull requests should be done into the **devel** branch.\n\nStatus: v0.6.2 alpha\n--------------------\n\n\nRequires:\n---------\n\n* [sdl2_nim](https://github.com/Vladar4/sdl2_nim) package (v2.0.14.2 or newer).\n* Runtime libraries for:\n * SDL 2.0.12 or newer\n * SDL_gfx 1.0.1\n * SDL_image 2.0.2\n * SDL_mixer 2.0.2\n * SDL_ttf 2.0.14\n(see [SDL2 links](https://github.com/Vladar4/sdl2_nim/blob/master/LINKS.md))\n\n\nOptional dependencies:\n----------------------\n\n* For plugin/mpeggraphic\n * mpg123 runtime library (dll is distributed within SDL_)\n* For plugin/tar:\n * [zip](https://github.com/nim-lang/zip)\n * zlib runtime library (dll is distributed within SDL2_image builds)\n* For plugin/zzip:\n * [zip](https://github.com/nim-lang/zip)\n * zlib runtime library (dll is distributed within SDL2_image builds)\n * zzip runtime library\n\n\nInstallation through [Nimble](https://github.com/nim-lang/nimble):\n------------------------------------------------------------------\n\n* stable version: `nimble install nimgame2@#head`\n* development version: `nimble install nimgame2@#devel`\n\n\nRecommended compilation flags:\n------------------------------\n`--multimethods:on -d:release --opt:speed`\n\n\nLinks:\n------\n\n* [home page](https://vladar4.github.io/nimgame2/)\n* [demos](demos)\n* [tutorials](https://vladar4.github.io/nimgame2/tutorials)\n* [documentation](https://vladar4.github.io/nimgame2/docs.html)\n* [ng2planetoids](https://github.com/Vladar4/ng2planetoids) - first demo game.\n* [ng2gggrotto](https://github.com/Vladar4/ng2gggrotto) - Linux Game Jam 2017 entry.\n\n\nChangelog:\n----------\n\n### v0.6.2 alpha (2021-08-20)\n* Maintenance release to keep up with the current versions of Nim and sdl2_nim until v0.7 is ready\n\n### v0.6.1 alpha (2019-06-15)\n* Nim v0.20.0 transition\n\n### v0.6 alpha (2019-01-21)\n* new modules: typewriter\n* new plugins: mpeggraphic (+demo22), tar, zzip\n* new utils procedures: textureFormat, textureFormats, toSeq, neg, new rand procedures\n* color constants\n* audio: playing template\n* emitter: emission areas, procedure argument for emit\n* entity: animation callback, blinking, scale parameters, dim template (by [CodeDoes](https://github.com/CodeDoes))\n* input: mouse wheel events (by [CodeDoes](https://github.com/CodeDoes))\n* icon surface init option\n* RW loading procedures\n* simplified time counters\n* demo23 (transform) (by [CodeDoes](https://github.com/CodeDoes))\n* various minor changes and upgrades, code refactoring\n* Nim v0.19.0 transition\n\n\n### v0.5 alpha (2017-08-01)\n* changed physics and logic systems\n* platformer physics\n* CoordInt type\n* now collider module is autmatically included into the entity module\n* group collider\n* huge Tilemap optimizations\n* various utility Tilemap procedures\n* TextureGraphic.drawTiled\n* GUI:\n * GUIProgressBar\n * widget actions\n* various minor changes and upgrades\n* Nim v0.17.0 transition\n* documentation, snippets, and demos update\n* [second tutorial](https://vladar4.github.io/nimgame2/tut102_platformer.html)\n\n### v0.4 alpha (2017-05-04)\n* GUI:\n * RadioGroup\n * RadioButton\n* IndexedImage\n* PerspectiveImage\n* TextureAtlas\n* joysticks support\n* window management procedures\n* 4 new demos\n* [first tutorial](https://vladar4.github.io/nimgame2/tut101_bounce.html)\n\n\n### v0.3 alpha (2017-03-10)\n* camera property (Scene)\n* new collision procedures\n* reworked input\n* Mosaic\n* parallax property (Entity)\n* TextField\n* GUI:\n * Widget\n * Button\n * TextInput\n* 3 new demos\n* home page, snippets, and documentation\n\n### v0.2 alpha (2017-01-31)\n* collider optimizations\n* music playlists\n* random procedures\n* tilemaps\n* tweens\n* emitters\n* various fixes\n* 4 new demos\n\n### v0.1 alpha (2017-01-16)\n* base scene/entity system\n* assets manager\n* basic sound and music\n* colliders (point, box, circle, line, and polygon)\n* fonts (bitmap and TrueType) and text output\n* keyboard and mouse input\n* vector drawing procedures\n\n" }, { "path": "STYLE.md", "content": "Nimgame 2 code formatting style\n===============================\n\nIn general, follow [NEP1](https://nim-lang.org/docs/nep1.html) if it doesn't contradict this document.\n\n\nLine Spacing\n------------\n* two empty lines before and one empty line after the header-comment;\n* two empty lines between blocks (such as `const`, `type`, `proc`, etc.);\n* one empty line to separate segments inside these blocks if needed;\n* one empty line at the end of files.\n\n\nComments\n--------\n\n* if there is more than one type declared in one module, their procedures should be separated with header-comments:\n ```\n #==========#\n # SomeType #\n #==========#\n ```\n* documentation comments are always offset by one indentation level inside their procedures, have two spaces before their text, and one empty comment line to separate it from the code below.\n ```\n proc someProc() =\n ## Documentation comment.\n ##\n var someVar\n ...\n ```\n\n\nNaming\n------\n* types and constants in PascalCase;\n* all other identifiers in camelCase;\n* if an object is a first argument of a procedure, generally it should be named after its type, e.g.:\n ```\n proc foo(bar: Bar, val: int): int =\n ```\n\n\nObjects\n-------\n* private and public fields should be separated with comments if possible;\n* `ref object` types should have the following initialization scheme:\n ```\n type SomeType = ref object of SomeParent\n someValue*: int\n\n\n proc initSomeType*(someType: SomeType) =\n someType.initSomeParent() # don't forget the parent initialization\n SomeType.someValue = 0\n ...\n\n\n proc newSomeType*(): SomeType =\n result = new SomeType\n result.initSomeType()\n ```\n* types that are inherited from the `Entity` type should follow the following update scheme:\n ```\n type\n SomeEntity = ref object of Entity\n\n\n proc updateSomeEntity*(someEntity: SomeEntiy, elapsed: float) =\n someEntity.updateEntity(elapsed) # don't forget the parent update\n ...\n\n\n method update*(someEntity: SomeEntiy, elapsed: float) =\n updateSomeEntity(someEntity, elapsed)\n ```\n\n\nCode\n----\n* don't forget proper spaces between elements;\n* procedural arguments are separated by commas, e.g.:\n ```\n proc someProc(arg1: int, arg2, arg3: float): float =\n ```\n* if there are a lot of arguments, they could be brought to a new line and indented by two levels for the sake of readability, e.g.:\n ```\n proc someLongAndComplexProcedure(\n arg1, arg2, arg3, arg4: int\n arg5, arg6, arg7, arg8: float) =\n ## Documentation\n ##\n ...\n ```\n\n\nExample\n-------\n ```\n # Header\n\n type\n SomeType1 = object\n # Private\n fHidden: int\n # Public\n value*: int\n\n SomeType2 = object\n a, b*: float\n\n\n const\n SomeConst1 = 42\n\n\n proc someProc*(arg1: int): int =\n ...\n\n\n #===========#\n # SomeType1 #\n #===========#\n\n proc someProc1*(someType1: SomeType1, a, b: int) =\n ...\n\n\n #===========#\n # SomeType2 #\n #===========#\n\n ...\n\n ```\n\n" }, { "path": "demos/README.md", "content": "Nimgame 2 Demos\n===============\n\n* [demo1](demo1) Performance\n\n* [demo2](demo2) Graphic\n\n* [demo3](demo3) Input\n\n* [demo4](demo4) Sprite\n\n* [demo5](demo5) Colliders\n\n* [demo6](demo6) Grouping\n\n* [demo7](demo7) Text\n\n* [demo8](demo8) ProcGraphic\n\n* [demo9](demo9) Audio\n\n* [demo10](demo10) Layers\n\n* [demo11](demo11) Tweens\n\n* [demo12](demo12) Emitters\n\n* [demo13](demo13) TileMaps\n\n* [demo14](demo14) TileMaps, Tweens, Emitters\n\n* [demo15](demo15) Camera\n\n* [demo16](demo16) Parallax\n\n* [demo17](demo17) GUI (Button, TextField)\n\n* [demo18](demo18) IndexedImage\n\n* [demo19](demo19) PerspectiveImage\n\n* [demo20](demo20) TextureAtlas\n\n* [demo21](demo21) Joysticks\n\n* [demo22](demo22) MpegGraphic\n\n* [demo23](demo23) Transform\n\n" }, { "path": "demos/assets/csv/atlas.csv", "content": "spaceman, 12, 33, 42, 66\ngradient, 65, 9, 16, 90\nbutton, 82, 26, 48, 72\nsprite, 132, 0, 68, 100\n" }, { "path": "demos/assets/csv/map0.csv", "content": "0,0,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3\n3,3,3,1,1,1,3,1,1,1,1,1,3,1,1,1,1,1,1,1,1,3,1,1,1,3\n3,1,1,1,1,1,1,1,1,1,3,1,1,1,3,3,3,3,1,1,1,3,1,2,1,3\n3,1,3,1,1,1,3,3,1,3,3,3,3,3,3,1,1,3,1,3,3,3,1,1,1,3\n3,1,3,3,1,3,3,1,1,1,1,1,1,1,1,1,1,3,1,3,0,3,3,1,3,3\n3,1,3,1,1,1,3,3,3,3,3,1,1,3,3,1,1,3,1,3,0,0,3,1,3,0\n3,1,1,1,1,1,1,1,1,1,3,3,1,3,3,3,1,3,1,3,3,3,3,1,3,0\n3,3,3,1,1,1,3,1,1,1,3,1,1,1,3,3,1,1,1,3,1,1,1,1,3,0\n0,0,3,3,1,3,3,1,1,1,3,1,1,1,3,3,3,3,3,3,3,3,3,1,3,0\n3,3,3,1,1,1,3,1,1,1,3,1,1,1,1,1,1,1,1,1,1,1,3,1,3,0\n3,1,1,1,1,1,3,3,3,1,3,3,3,3,3,3,3,3,3,3,3,1,1,1,3,0\n3,1,3,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,3,3,3,3,3,3\n3,1,3,3,3,3,3,3,3,1,3,3,3,3,3,3,1,3,1,1,1,1,1,1,1,3\n3,1,1,1,1,1,1,1,3,1,3,3,1,1,1,3,1,3,1,3,3,3,3,3,1,3\n3,3,3,1,3,1,1,1,3,1,3,3,1,1,1,3,1,3,1,3,1,1,1,3,1,3\n0,0,3,1,3,1,3,3,3,1,3,3,1,1,1,1,1,3,1,3,1,1,1,1,1,3\n3,3,3,3,3,1,3,3,1,1,1,3,3,3,3,3,1,3,1,3,1,1,1,3,1,3\n3,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,3,1,3,3,3,3,3,1,3\n3,1,1,3,3,3,3,3,1,1,1,3,3,3,3,3,3,3,1,1,1,1,1,1,1,3\n3,3,3,3,0,0,0,3,3,3,3,3,0,0,0,0,0,3,3,3,3,3,3,3,3,3\n" }, { "path": "demos/assets/csv/map_camera_test.csv", "content": "1,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,1\n3,2,3,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,3,2,3\n1,3,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,3,1\n1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1\n3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3\n3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3\n1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1\n1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1\n3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3\n3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3\n1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1\n1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1\n3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3\n3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3\n1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1\n1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1\n3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3\n3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3\n1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1\n1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1\n3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3\n3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3\n1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1\n1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1\n3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3\n3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3\n1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1\n1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1\n3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3\n3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3\n1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1\n1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1\n3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3\n3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3\n1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1\n1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1\n3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3\n3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3\n1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1\n1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1\n3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3\n3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3\n1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1\n1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1\n3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3\n3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3,1,3,1,1,3,1,3,3\n1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1,1,3,3,3,3,1,1,1\n1,3,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,3,1\n3,2,3,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,3,2,3\n1,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,3,1,1,3,1\n" }, { "path": "demos/demo1/README.md", "content": "Nimgame 2: Demo 1\n=================\n\nPerformance demo.\n\n![Screenshot](demo1.png)\n\n" }, { "path": "demos/demo1/demo1.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/settings,\n mainscene\n\ngame = newGame()\nif game.init(w = 640, h = 480, title = \"Nimgame 2: Demo 1 (Performance)\"):\n showInfo = true\n game.scene = newMainScene()\n game.run()\n\n" }, { "path": "demos/demo1/mainscene.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/draw,\n nimgame2/entity,\n nimgame2/texturegraphic,\n nimgame2/scene,\n nimgame2/settings,\n nimgame2/types,\n spaceman\n\n\nconst\n NumMin = 100\n NumMax = 50_000\n NumStep = 100\n NumStart = 500\n\n\ntype\n MainScene = ref object of Scene\n spacemanG: TextureGraphic\n num: int\n\n\nproc spacemanPhysics*(entity: Entity, elapsed: float) =\n defaultPhysics(entity, elapsed)\n\n # Screen collision\n if entity.pos.x < 0:\n entity.vel.x *= -1\n if entity.pos.y < 0:\n entity.vel.y *= -1\n if entity.pos.x >= game.size.w.float:\n entity.vel.x *= -1\n if entity.pos.y >= game.size.h.float:\n entity.vel.y *= -1\n\n\nproc init*(scene: MainScene) =\n Scene(scene).init()\n scene.spacemanG = newTextureGraphic()\n discard scene.spacemanG.load(\"../assets/gfx/spaceman.png\")\n scene.num = NumStart\n for i in 1..scene.num:\n scene.add(newSpaceman(scene, scene.spacemanG, spacemanPhysics))\n\n\nproc free*(scene: MainScene) =\n scene.spacemanG.free\n\n\nproc newMainScene*(): MainScene =\n new result, free\n result.init()\n\n\nmethod event*(scene: MainScene, event: Event) =\n if event.kind == KeyDown:\n case event.key.keysym.sym:\n of K_Escape:\n gameRunning = false\n of K_Up:\n if scene.num < NumMax:\n scene.num += NumStep\n for i in scene.count..scene.num-1:\n scene.add(newSpaceman(scene, scene.spacemanG, spacemanPhysics))\n of K_Down:\n if scene.num > NumMin:\n scene.num -= NumStep\n for i in scene.num..(scene.count - 1):\n discard scene.pop()\n else: discard\n\n\nmethod render*(scene: MainScene) =\n scene.renderScene()\n discard box((4, 60), (260, 84), 0x000000CC'u32)\n discard string(\n (8, 64), \"Arrow Up - more entities\", 0xFF0000FF'u32)\n discard string(\n (8, 72), \"Arrow Down - less entities\", 0xFF0000FF'u32)\n\n\nmethod update*(scene: MainScene, elapsed: float) =\n scene.updateScene(elapsed)\n\n" }, { "path": "demos/demo1/spaceman.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/entity,\n nimgame2/graphic,\n nimgame2/scene,\n nimgame2/types,\n nimgame2/utils\n\ntype\n Spaceman* = ref object of Entity\n scene*: Scene\n\n\nproc init*(entity: Spaceman, s: Scene, g: Graphic, p: PhysicsProc) =\n entity.initEntity()\n entity.scene = s\n entity.graphic = g\n entity.physics = p\n entity.pos.x = rand(game.size.w).float\n entity.pos.y = rand(game.size.h).float\n entity.vel.x = rand(10.0..100.0) * randSign().float\n entity.vel.y = rand(10.0..100.0) * randSign().float\n entity.centrify()\n entity.rot = rand(360.0)\n entity.rotVel = rand(10.0..60.0) * randSign().float\n\n\nproc newSpaceman*(s: Scene, g: Graphic, p: PhysicsProc): Spaceman =\n result = new Spaceman\n result.init(s, g, p)\n\n" }, { "path": "demos/demo10/README.md", "content": "Nimgame 2: Demo 10\n==================\n\nLayers demo. Demonstrates entity layering.\n\n![Screenshot](demo10.png)\n\n" }, { "path": "demos/demo10/demo10.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/settings,\n mainscene\n\ngame = newGame()\nif game.init(w = 640, h = 480, title = \"Nimgame 2: Demo 10 (Layers)\"):\n showInfo = true\n game.scene = newMainScene()\n game.run()\n\n" }, { "path": "demos/demo10/earth.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/entity\n\ntype\n Earth* = ref object of Entity\n\n\nproc init*(entity: Earth) =\n entity.initEntity()\n entity.pos.x = 128.0\n entity.pos.y = 96.0\n\n\nproc newEarth*(): Earth =\n result = new Earth\n result.init()\n\n" }, { "path": "demos/demo10/mainscene.nim", "content": "import\n math,\n nimgame2/nimgame,\n nimgame2/draw,\n nimgame2/entity,\n nimgame2/texturegraphic,\n nimgame2/input,\n nimgame2/scene,\n nimgame2/settings,\n nimgame2/types,\n earth, spaceman\n\n\ntype\n MainScene = ref object of Scene\n earthG, spacemanG: TextureGraphic\n e: Earth\n s: Spaceman\n\n\nproc init*(scene: MainScene) =\n Scene(scene).init()\n # Earth\n scene.e = newEarth()\n scene.earthG = newTextureGraphic()\n discard scene.earthG.load(\"../assets/gfx/earth.png\")\n scene.e.graphic = scene.earthG\n # Spaceman\n scene.s = newSpaceman()\n scene.spacemanG = newTextureGraphic()\n discard scene.spacemanG.load(\"../assets/gfx/spaceman.png\")\n scene.s.graphic = scene.spacemanG\n\n # add to scene\n scene.add(scene.s)\n scene.add(scene.e)\n\n\nproc free*(scene: MainScene) =\n scene.earthG.free\n scene.spacemanG.free\n\n\nproc newMainScene*(): MainScene =\n new result, free\n result.init()\n\n\nmethod event*(scene: MainScene, event: Event) =\n if event.kind == KeyDown:\n case event.key.keysym.sym:\n of K_Escape:\n gameRunning = false\n else: discard\n\n\nmethod render*(scene: MainScene) =\n scene.renderScene()\n discard box((4, 60), (220, 76), 0x000000CC'u32)\n discard string(\n (8, 64), \"1/2 - Change layer\", 0xFF0000FF'u32)\n\n\nmethod update*(scene: MainScene, elapsed: float) =\n scene.updateScene(elapsed)\n if Scancode1.down: scene.s.layer = -1\n if Scancode2.down: scene.s.layer = 1\n\n" }, { "path": "demos/demo10/spaceman.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/entity\n\ntype\n Spaceman* = ref object of Entity\n\n\nproc init*(entity: Spaceman) =\n entity.initEntity()\n entity.pos.x = 200.0\n entity.pos.y = 64.0\n\n\nproc newSpaceman*(): Spaceman =\n result = new Spaceman\n result.init()\n\n" }, { "path": "demos/demo11/README.md", "content": "Nimgame 2: Demo 11\n==================\n\nTweens demo. Demonstrates tweening procedures.\n\n![Screenshot](demo11.png)\n\n" }, { "path": "demos/demo11/demo11.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/settings,\n mainscene\n\ngame = newGame()\nif game.init(w = 1280, h = 720, title = \"Nimgame 2: Demo 11 (Tweens)\"):\n #showInfo = true\n game.scene = newMainScene()\n game.run()\n\n" }, { "path": "demos/demo11/earth.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/entity,\n nimgame2/types\n\ntype\n Earth* = ref object of Entity\n\n\nproc init*(entity: Earth, pos: Coord) =\n entity.initEntity()\n entity.pos = pos\n\n\nproc newEarth*(pos: Coord): Earth =\n result = new Earth\n result.init(pos)\n\n" }, { "path": "demos/demo11/mainscene.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/bitmapfont,\n nimgame2/draw,\n nimgame2/entity,\n nimgame2/textgraphic,\n nimgame2/texturegraphic,\n nimgame2/input,\n nimgame2/scene,\n nimgame2/settings,\n nimgame2/tween,\n nimgame2/types,\n earth\n\n\ntype\n MainScene = ref object of Scene\n earthG: TextureGraphic\n font: BitmapFont\n tweens: seq[Tween[Entity,Coord]]\n\n\nproc addEntity*(scene: MainScene,\n name: string,\n pos: Coord,\n procedure: TweenProcedure[Coord]) =\n # Name\n let n = newTextGraphic()\n n.font = scene.font\n n.lines = [name]\n let ne = newEntity()\n ne.graphic = n\n ne.pos = pos - (98.0, 8.0)\n scene.add(ne)\n\n # Entity\n let e = newEarth(pos)\n e.graphic = scene.earthG\n e.centrify()\n scene.add(e)\n\n # Tween\n let t = newTween[Entity,Coord](\n e,\n proc(t: Entity): Coord = t.pos,\n proc(t: Entity, val: Coord) = t.pos = val)\n t.procedure = procedure\n scene.tweens.add(t)\n t.setup(e.pos, e.pos + (150.0, 0.0), 3.0, -1)\n t.play()\n\n\nproc init*(scene: MainScene) =\n Scene(scene).init()\n scene.tweens = @[]\n\n # Earth graphic\n scene.earthG = newTextureGraphic()\n discard scene.earthG.load(\"../assets/gfx/earth32.png\")\n\n # Font\n scene.font = newBitmapFont()\n discard scene.font.load(\"../assets/fnt/default8x16.png\", (8, 16))\n\n # Column 1\n scene.addEntity(\"linear\", (100.0, 35.0), linear)\n scene.addEntity(\"inQuad\", (100.0, 85.0), inQuad)\n scene.addEntity(\"outQuad\", (100.0, 135.0), outQuad)\n scene.addEntity(\"inOutQuad\", (100.0, 185.0), inOutQuad)\n\n scene.addEntity(\"inCubic\", (100.0, 285.0), inCubic)\n scene.addEntity(\"outCubic\", (100.0, 335.0), outCubic)\n scene.addEntity(\"inOutCubic\", (100.0, 385.0), inOutCubic)\n scene.addEntity(\"outInCubic\", (100.0, 435.0), outInCubic)\n\n scene.addEntity(\"inQuart\", (100.0, 535.0), inQuart)\n scene.addEntity(\"outQuart\", (100.0, 585.0), outQuart)\n scene.addEntity(\"inOutQuart\", (100.0, 635.0), inOutQuart)\n scene.addEntity(\"outInQuart\", (100.0, 685.0), outInQuart)\n\n # Column 2\n scene.addEntity(\"inQuint\", (400.0, 35.0), inQuint)\n scene.addEntity(\"outQuint\", (400.0, 85.0), outQuint)\n scene.addEntity(\"inOutQuint\", (400.0, 135.0), inOutQuint)\n scene.addEntity(\"outInQuint\", (400.0, 185.0), outInQuint)\n\n scene.addEntity(\"inSine\", (400.0, 285.0), inSine)\n scene.addEntity(\"outSine\", (400.0, 335.0), outSine)\n scene.addEntity(\"inOutSine\", (400.0, 385.0), inOutSine)\n scene.addEntity(\"outInSine\", (400.0, 435.0), outInSine)\n\n # Column 3\n scene.addEntity(\"inExpo\", (700.0, 35.0), inExpo)\n scene.addEntity(\"outExpo\", (700.0, 85.0), outExpo)\n scene.addEntity(\"inOutExpo\", (700.0, 135.0), inOutExpo)\n scene.addEntity(\"outInExpo\", (700.0, 185.0), outInExpo)\n\n scene.addEntity(\"inCirc\", (700.0, 285.0), inCirc)\n scene.addEntity(\"outCirc\", (700.0, 335.0), outCirc)\n scene.addEntity(\"inOutCirc\", (700.0, 385.0), inOutCirc)\n scene.addEntity(\"outInCirc\", (700.0, 435.0), outInCirc)\n\n # Column 4\n scene.addEntity(\"inBounce\", (1000.0, 35.0), inBounce)\n scene.addEntity(\"outBounce\", (1000.0, 85.0), outBounce)\n scene.addEntity(\"inOutBounce\", (1000.0, 135.0), inOutBounce)\n scene.addEntity(\"outInBounce\", (1000.0, 185.0), outInBounce)\n\n scene.addEntity(\"inElastic\", (1000.0, 285.0), inElastic)\n scene.addEntity(\"outElastic\", (1000.0, 335.0), outElastic)\n scene.addEntity(\"inOutElastic\", (1000.0, 385.0), inOutElastic)\n scene.addEntity(\"outInElastic\", (1000.0, 435.0), outInElastic)\n\n scene.addEntity(\"inBack\", (1000.0, 535.0), inBack)\n scene.addEntity(\"outBack\", (1000.0, 585.0), outBack)\n scene.addEntity(\"inOutBack\", (1000.0, 635.0), inOutBack)\n scene.addEntity(\"outInBack\", (1000.0, 685.0), outInBack)\n\n\nproc free*(scene: MainScene) =\n scene.earthG.free\n\n\nproc newMainScene*(): MainScene =\n new result, free\n result.init()\n\n\nmethod event*(scene: MainScene, event: Event) =\n if event.kind == KeyDown:\n case event.key.keysym.sym:\n of K_Escape:\n gameRunning = false\n else: discard\n\n\nmethod render*(scene: MainScene) =\n scene.renderScene()\n\n\nmethod update*(scene: MainScene, elapsed: float) =\n for tween in scene.tweens:\n tween.update(elapsed)\n scene.updateScene(elapsed)\n\n" }, { "path": "demos/demo12/README.md", "content": "Nimgame 2: Demo 12\n==================\n\nEmitter demo. Demonstrates particle emitter usage.\n\n![Screenshot](demo12.png)\n\n" }, { "path": "demos/demo12/demo12.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/settings,\n mainscene\n\ngame = newGame()\nif game.init(w = 640, h = 480, title = \"Nimgame 2: Demo 12 (Emitter)\"):\n showInfo = true\n game.scene = newMainScene()\n game.run()\n\n" }, { "path": "demos/demo12/mainscene.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/draw,\n nimgame2/entity,\n nimgame2/emitter,\n nimgame2/texturegraphic,\n nimgame2/input,\n nimgame2/scene,\n nimgame2/settings,\n nimgame2/types\n\n\ntype\n MainScene = ref object of Scene\n particleG: TextureGraphic\n ePoint, eLine, eCircle, eBox, eScaled: Emitter\n\n\nproc init*(scene: MainScene) =\n Scene(scene).init()\n # Particle Graphic\n scene.particleG = newTextureGraphic()\n discard scene.particleG.load(\"../assets/gfx/puff.png\")\n\n # Particle\n var particle: Particle\n particle = newParticle()\n particle.graphic = scene.particleG\n particle.initSprite((5, 5))\n particle.centrify()\n discard particle.addAnimation(\"play\", toSeq(0..4), 1/5)\n particle.play(\"play\", 1, kill = true)\n\n # Point emitter\n scene.ePoint = newEmitter(scene)\n scene.ePoint.randomVel = (10.0, 10.0)\n scene.ePoint.randomAcc = (5.0, 5.0)\n scene.ePoint.randomTTL = 5.0\n scene.ePoint.particle = particle\n scene.add(scene.ePoint)\n\n # Line emitter\n scene.eLine = newEmitter(scene, eaLine)\n scene.eLine.area.length = 100.0\n scene.eLine.randomVel = (10.0, 10.0)\n scene.eLine.randomAcc = (5.0, 5.0)\n scene.eLine.randomTTL = 5.0\n scene.eLine.particle = particle\n scene.eLine.pos = game.size / 2\n scene.add(scene.eLine)\n\n # Circle emitter\n scene.eCircle = newEmitter(scene, eaCircle)\n scene.eCircle.area.radius = 100.0\n scene.eCircle.randomVel = (10.0, 10.0)\n scene.eCircle.randomAcc = (5.0, 5.0)\n scene.eCircle.randomTTL = 5.0\n scene.eCircle.particle = particle\n scene.eCircle.pos = game.size / 4\n scene.add(scene.eCircle)\n\n # Box emitter\n scene.eBox = newEmitter(scene, eaBox)\n scene.eBox.area.dim = (100.0, 50.0)\n scene.eBox.rotVel = -90.0\n scene.eBox.randomVel = (10.0, 10.0)\n scene.eBox.randomAcc = (5.0, 5.0)\n scene.eBox.randomTTL = 5.0\n scene.eBox.particle = particle\n scene.eBox.pos = game.size / 2 + game.size / 4\n scene.add(scene.eBox)\n\n # Scaling particles\n var particleScaled: Particle\n particleScaled = newParticle()\n particleScaled.graphic = scene.particleG\n particleScaled.initSprite((5, 5))\n particleScaled.centrify()\n discard particleScaled.addAnimation(\"play\", toSeq(0..4), 1/2)\n particleScaled.play(\"play\", 1, kill = true)\n particleScaled.scale = 0.5\n particleScaled.scaleVel = 1.0\n\n scene.eScaled = newEmitter(scene)\n scene.eScaled.randomVel = (50.0, 50.0)\n scene.eScaled.randomAcc = (5.0, 5.0)\n scene.eScaled.randomTTL = 5.0\n scene.eScaled.particle = particleScaled\n scene.eScaled.pos = (game.size.w div 2 + game.size.w div 4, game.size.h div 4)\n scene.add(scene.eScaled)\n\n\n\nproc free*(scene: MainScene) =\n scene.particleG.free()\n\n\nproc newMainScene*(): MainScene =\n new result, free\n result.init()\n\n\nmethod event*(scene: MainScene, event: Event) =\n if event.kind == KeyDown:\n case event.key.keysym.sym:\n of K_Escape:\n gameRunning = false\n else: discard\n\n\nmethod render*(scene: MainScene) =\n # Draw line between the spaceman and the mouse position if LMB is pressed\n scene.renderScene()\n\n\nmethod update*(scene: MainScene, elapsed: float) =\n scene.updateScene(elapsed)\n # Point emitter\n scene.ePoint.pos = mouse.abs\n if MouseButton.left.down:\n scene.ePoint.emit(5)\n # Line emitter\n scene.eLine.rot += 90 * elapsed\n scene.eLine.emit(5)\n # Circle emitter\n scene.eCircle.area.radius = if MouseButton.left.down: 50.0 else: 100.0\n scene.eCircle.emit(scene.eCircle.area.radius.int div 20)\n # Box emitter\n scene.eBox.rot += scene.eBox.rotVel * elapsed\n scene.eBox.emit(5)\n # Scaled emitter\n scene.eScaled.emit(5)\n\n" }, { "path": "demos/demo13/README.md", "content": "Nimgame 2: Demo 13\n==================\n\nTileMap demo. Demonstrates tile maps usage.\n\nNote\n----\nFor the performance purposes TileCollider is based on BoxCollider. It means, that usually you shouldn't initialize collider on a TileMap that will be rotated.\n\n![Screenshot](demo13.png)\n\n" }, { "path": "demos/demo13/cursor.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/entity,\n nimgame2/input,\n nimgame2/tilemap\n\ntype\n Cursor* = ref object of Entity\n collidedWith*: seq[string]\n\n\nproc init*(entity: Cursor) =\n entity.initEntity()\n entity.tags.add(\"Cursor\")\n entity.pos = mouse.abs\n entity.collidedWith = @[]\n\n\nproc newCursor*(): Cursor =\n result = new Cursor\n result.init()\n\n\nmethod update*(entity: Cursor, elapsed: float) =\n entity.updateEntity(elapsed)\n entity.collidedWith = @[]\n entity.pos = mouse.abs\n\n\nmethod onCollide*(entity: Cursor, target: Entity) =\n if target.tags.len > 0:\n if \"map\" in target.tags:\n let collider = TilemapCollider(target.collider)\n let clist = collider.collisionList(entity.pos)\n for tile in clist:\n entity.collidedWith.add(\n \"[\" & $tile.index.x & \":\" & $tile.index.y & \"] -> \" & $tile.value)\n\n" }, { "path": "demos/demo13/demo13.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/settings,\n mainscene\n\ngame = newGame()\nif game.init(w = 640, h = 480, title = \"Nimgame 2: Demo 13 (TileMap)\"):\n showInfo = true\n game.scene = newMainScene()\n game.run()\n\n" }, { "path": "demos/demo13/mainscene.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/draw,\n nimgame2/entity,\n nimgame2/texturegraphic,\n nimgame2/tilemap,\n nimgame2/input,\n nimgame2/scene,\n nimgame2/settings,\n nimgame2/types,\n cursor\n\n\ntype\n MainScene = ref object of Scene\n tilesG: TextureGraphic\n tm: TileMap\n cursor: Cursor\n\n\nproc init*(scene: MainScene) =\n Scene(scene).init()\n\n # Cursor\n hideCursor()\n scene.cursor = newCursor()\n let cursorG = newTextureGraphic()\n discard cursorG.load(\"../assets/gfx/cursor.png\")\n scene.cursor.graphic = cursorG\n scene.cursor.collider = newCollider(scene.cursor)\n scene.add(scene.cursor)\n\n # Tiles Graphic\n scene.tilesG = newTextureGraphic()\n discard scene.tilesG.load(\"../assets/gfx/sprite0.png\")\n # TileMap\n scene.tm = newTileMap(scaleFix = true)\n scene.tm.tags.add(\"map\")\n scene.tm.graphic = scene.tilesG\n scene.tm.initSprite((64, 64), offset = (32, 32))\n scene.tm.map = @[\n @[0, 0, 0, 0],\n @[1, 0, 0, 1],\n @[2, 3, 3, 2]\n ]\n scene.tm.passable.add(0)\n scene.tm.centrify()\n scene.tm.initCollider()\n scene.tm.pos = (320.0, 240.0)\n scene.add(scene.tm)\n\n\n\nproc free*(scene: MainScene) =\n scene.tilesG.free()\n\n\nproc newMainScene*(): MainScene =\n new result, free\n result.init()\n\n\nmethod event*(scene: MainScene, event: Event) =\n if event.kind == KeyDown:\n case event.key.keysym.sym:\n of K_Escape:\n gameRunning = false\n of K_Space:\n colliderOutline = not colliderOutline\n else: discard\n\n\nmethod render*(scene: MainScene) =\n scene.renderScene()\n discard box((4, 60), (300, 108), 0x000000CC'u32)\n\n discard string((8, 64), \"WSAD or Arrows - move\", 0xFFFFFFFF'u32)\n\n discard string((8, 72), \"Q/E - change angle\", 0xFFFFFFFF'u32)\n\n discard string((8, 80), \"R/F - change scale\", 0xFFFFFFFF'u32)\n\n discard string((8, 88), \"Space - toggle collider outlines\", 0xFFFFFFFF'u32)\n\n var collides: string = \"\"\n for collision in scene.cursor.collidedWith:\n collides &= collision & \" \"\n\n discard string((8, 96),\n if scene.cursor.collidedWith.len > 0:\n \"Cursor collides with: \" & collides\n else:\n \"Cursor isn't over a collidable tile\",\n 0xFFFFFFFF'u32)\n\n\nmethod update*(scene: MainScene, elapsed: float) =\n scene.updateScene(elapsed)\n if ScancodeW.down or ScancodeUp.down: scene.tm.pos.y -= 100 * elapsed\n if ScancodeS.down or ScancodeDown.down: scene.tm.pos.y += 100 * elapsed\n if ScancodeA.down or ScancodeLeft.down: scene.tm.pos.x -= 100 * elapsed\n if ScancodeD.down or ScancodeRight.down: scene.tm.pos.x += 100 * elapsed\n if ScancodeQ.down: scene.tm.rot -= 100 * elapsed\n if ScancodeE.down: scene.tm.rot += 100 * elapsed\n if ScancodeR.down: scene.tm.scale -= 0.5 * elapsed\n if ScancodeF.down: scene.tm.scale += 0.5 * elapsed\n\n" }, { "path": "demos/demo14/README.md", "content": "Nimgame 2: Demo 14\n==================\n\nSecond TileMap demo. Demonstrates practical TileMap usage, along with Tween an Emitter usage.\n\nF10 - Show/Hide info panel.\n\n![Screenshot](demo14.png)\n\n" }, { "path": "demos/demo14/demo14.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/settings,\n mainscene\n\ngame = newGame()\nif game.init(w = 640, h = 480, title = \"Nimgame 2: Demo 14 (TileMap 2)\"):\n showInfo = true\n game.scene = newMainScene()\n game.run()\n\n" }, { "path": "demos/demo14/dwarf.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/entity,\n nimgame2/texturegraphic,\n nimgame2/tilemap,\n nimgame2/tween,\n nimgame2/types\n\n\nconst\n Framerate = 1/12\n ScreenOffset*: Coord = (8.0, 0.0)\n Step* = 24.0\n\n\ntype\n Direction* = enum dNone, dDown, dUp, dLeft, dRight\n\n Dwarf* = ref object of Entity\n tween*: Tween[Dwarf,Coord]\n virtualPos*: tuple[x: int, y: int]\n map*: TileMap\n\n\nproc init*(entity: Dwarf, graphic: TextureGraphic, map: TileMap) =\n entity.initEntity()\n entity.tags.add(\"dwarf\")\n entity.graphic = graphic\n entity.initSprite((24, 48))\n discard entity.addAnimation(\n \"down\", [0, 1, 2, 3, 4, 5], Framerate)\n discard entity.addAnimation(\n \"up\", [6, 7, 8, 9, 10, 11], Framerate)\n discard entity.addAnimation(\n \"left\", [12, 13, 14, 15, 16, 17], Framerate)\n discard entity.addAnimation(\n \"right\", [12, 13, 14, 15, 16, 17], Framerate, Flip.horizontal)\n entity.pos = (44.0, 444.0)\n entity.virtualPos = (1, 18)\n entity.center = (12.0, 36.0)\n entity.map = map\n entity.map.show = (\n x: (entity.virtualPos.x - 2)..(entity.virtualPos.x + 2),\n y: (entity.virtualPos.y - 2)..(entity.virtualPos.y + 2)\n )\n\n\nproc newDwarf*(graphic: TextureGraphic, map: TileMap): Dwarf =\n result = new Dwarf\n result.init(graphic, map)\n\n\nproc actuate(entity: Dwarf, anim: string, movement: Coord) =\n if entity.tween == nil or not entity.tween.playing:\n let\n newPos = entity.pos + movement\n newVirtualPos: tuple[x: int, y: int] =\n (int(newPos.x - ScreenOffset.x) div Step.int,\n int(newPos.y - ScreenOffset.y) div Step.int)\n\n if entity.map.map[newVirtualPos.y][newVirtualPos.x] > 2:\n return # unpassable\n\n entity.play(anim, 1)\n entity.tween = newTween[Dwarf,Coord](\n entity,\n proc(t: Dwarf): Coord = t.pos,\n proc(t: Dwarf, val: Coord) = t.pos = val)\n entity.tween.setup(entity.pos, newPos, 0.5, 0)\n entity.virtualPos = newVirtualPos\n entity.tween.play()\n entity.map.show = (\n x: (newVirtualPos.x - 2)..(newVirtualPos.x + 2),\n y: (newVirtualPos.y - 2)..(newVirtualPos.y + 2)\n )\n\n\nproc move*(entity: Dwarf, direction: Direction) =\n case direction:\n of dDown: entity.actuate(\"down\", (0.0, Step))\n of dUp: entity.actuate(\"up\", (0.0, -Step))\n of dRight: entity.actuate(\"right\", (Step, 0.0))\n of dLeft: entity.actuate(\"left\", (-Step, 0.0))\n of dNone: discard\n\n" }, { "path": "demos/demo14/mainscene.nim", "content": "import\n parseutils,\n nimgame2/nimgame,\n nimgame2/draw,\n nimgame2/emitter,\n nimgame2/entity,\n nimgame2/texturegraphic,\n nimgame2/tilemap,\n nimgame2/input,\n nimgame2/scene,\n nimgame2/settings,\n nimgame2/tween,\n nimgame2/types,\n nimgame2/utils,\n dwarf\n\n\ntype\n MainScene = ref object of Scene\n dG, tilesG, sparkG: TextureGraphic\n d: Dwarf\n sparks: Emitter\n map: TileMap\n\n\nproc init*(scene: MainScene) =\n Scene(scene).init()\n\n # Spark\n scene.sparkG = newTextureGraphic()\n discard scene.sparkG.load(\"../assets/gfx/puff.png\")\n\n # TileMap\n scene.tilesG = newTextureGraphic()\n discard scene.tilesG.load(\"../assets/gfx/tile0.png\")\n scene.map = newTileMap()\n scene.map.tags.add(\"map\")\n scene.map.graphic = scene.tilesG\n scene.map.initSprite((24, 24))\n scene.map.map = loadCSV[int](\n \"../assets/csv/map0.csv\",\n proc(input: string): int = discard parseInt(input, result))\n scene.map.pos = (8.0, 0.0)\n\n # Dwarf\n scene.dG = newTextureGraphic()\n discard scene.dG.load(\"../assets/gfx/dwarf.png\")\n scene.d = newDwarf(scene.dG, scene.map)\n scene.d.layer = 10\n\n # Add to scene\n scene.add(scene.d)\n scene.add(scene.map)\n\nproc free*(scene: MainScene) =\n scene.dG.free\n\n\nproc newMainScene*(): MainScene =\n new result, free\n result.init()\n\n\nmethod event*(scene: MainScene, event: Event) =\n if event.kind == KeyDown:\n case event.key.keysym.sym:\n of K_Escape:\n gameRunning = false\n of K_F10:\n showInfo = not showInfo\n else: discard\n\n\nmethod render*(scene: MainScene) =\n scene.renderScene()\n\n\nmethod update*(scene: MainScene, elapsed: float) =\n scene.updateScene(elapsed)\n if scene.d.tween != nil:\n scene.d.tween.update(elapsed)\n\n # Controls and speed\n var direction: dwarf.Direction =\n if ScancodeDown.down or ScancodeS.down: dDown\n elif ScancodeUp.down or ScancodeW.down: dUp\n elif ScancodeLeft.down or ScancodeA.down: dLeft\n elif ScancodeRight.down or ScancodeD.down: dRight\n else: dNone\n\n scene.d.move(direction)\n\n # Sparks\n if scene.sparks == nil:\n if scene.map.map[scene.d.virtualPos.y][scene.d.virtualPos.x] == 2:\n scene.sparks = newEmitter(scene)\n scene.sparks.pos = ((scene.d.virtualPos.x.float,\n scene.d.virtualPos.y.float) * Step) +\n ScreenOffset + scene.d.center - (0.0, Step)\n scene.sparks.randomVel = (25.0, 25.0)\n scene.sparks.randomAcc = (10.0, 10.0)\n scene.sparks.randomTTL = 2.5\n scene.sparks.particle = newParticle()\n scene.sparks.particle.graphic = scene.sparkG\n scene.sparks.particle.initSprite((5, 5))\n scene.sparks.particle.centrify()\n discard scene.sparks.particle.addAnimation(\"play\", toSeq(0..4), 1/5)\n scene.sparks.particle.play(\"play\", 1, kill = true)\n scene.add(scene.sparks)\n else:\n scene.sparks.emit(10)\n\n\n" }, { "path": "demos/demo15/README.md", "content": "Nimgame 2: Demo 15\n==================\n\nCamera demo. Demonstrates camera usage.\n\nNote a negative sign in front of the camera's position.\n\n![Screenshot](demo15.png)\n\n" }, { "path": "demos/demo15/demo15.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/settings,\n mainscene\n\ngame = newGame()\nif game.init(w = 640, h = 480, title = \"Nimgame 2: Demo 15 (Camera)\"):\n showInfo = true\n game.scene = newMainScene()\n game.run()\n\n" }, { "path": "demos/demo15/mainscene.nim", "content": "import\n parseutils,\n nimgame2/nimgame,\n nimgame2/draw,\n nimgame2/entity,\n nimgame2/texturegraphic,\n nimgame2/tilemap,\n nimgame2/input,\n nimgame2/scene,\n nimgame2/settings,\n nimgame2/types,\n nimgame2/utils\n\n\ntype\n MainScene = ref object of Scene\n tilesG, spacemanG: TextureGraphic\n spaceman: Entity\n map: TileMap\n\n\nproc init*(scene: MainScene) =\n Scene(scene).init()\n\n scene.camera = newEntity()\n scene.cameraBondOffset = game.size / 2\n\n # Tiles Graphic\n scene.tilesG = newTextureGraphic()\n discard scene.tilesG.load(\"../assets/gfx/tile0.png\")\n\n # TileMap\n scene.map = newTileMap(scaleFix = true)\n scene.map.parent = scene.camera\n scene.map.tags.add(\"map\")\n scene.map.graphic = scene.tilesG\n scene.map.initSprite((24, 24))\n scene.map.map = loadCSV[int](\"../assets/csv/map_camera_test.csv\",\n proc(s: string): int = discard parseInt(s, result))\n scene.map.passable.add(0)\n scene.map.initCollider()\n scene.map.pos = (0.0, 0.0)\n\n # SpacemanG\n scene.spacemanG = newTextureGraphic()\n discard scene.spacemanG.load(\"../assets/gfx/spaceman.png\")\n\n # Spaceman\n scene.spaceman = newEntity()\n scene.spaceman.parent = scene.map\n scene.spaceman.graphic = scene.spacemanG\n scene.spaceman.centrify()\n scene.spaceman.pos = (200.0, 200.0)\n\n # Add\n scene.add(scene.spaceman)\n scene.add(scene.map)\n\n\n\nproc free*(scene: MainScene) =\n scene.tilesG.free()\n scene.spacemanG.free()\n\n\nproc newMainScene*(): MainScene =\n new result, free\n result.init()\n\n\nmethod event*(scene: MainScene, event: Event) =\n if event.kind == KeyDown:\n case event.key.keysym.sym:\n of K_Escape:\n gameRunning = false\n of K_Space:\n colliderOutline = not colliderOutline\n of K_Return:\n scene.cameraBond = if scene.cameraBond != nil: nil\n else: scene.spaceman\n else: discard\n\n\nmethod render*(scene: MainScene) =\n scene.renderScene()\n discard box((4, 60), (300, 108), 0x000000CC'u32)\n\n discard string((8, 64), \"Arrows - move camera\", 0xFFFFFFFF'u32)\n discard string((8, 72), \"WSAD - move spaceman\", 0xFFFFFFFF'u32)\n discard string((8, 80), \"Enter - toggle following (\" &\n (if scene.cameraBond != nil: \"on\" else: \"off\") & \")\", 0xFFFFFFFF'u32)\n\n discard string((8, 88), \"camera.pos = \" & $(-scene.camera.pos),\n 0xFFFFFFFF'u32)\n discard string((8, 96), \"spaceman.pos = \" & $(scene.spaceman.pos),\n 0xFFFFFFFF'u32)\n\n\nmethod update*(scene: MainScene, elapsed: float) =\n scene.updateScene(elapsed)\n let move = 100 * elapsed\n if scene.cameraBond == nil:\n if ScancodeUp.down: scene.camera.pos.y += move\n if ScancodeDown.down: scene.camera.pos.y -= move\n if ScancodeLeft.down: scene.camera.pos.x += move\n if ScancodeRight.down: scene.camera.pos.x -= move\n if ScancodeW.down: scene.spaceman.pos.y -= move\n if ScancodeS.down: scene.spaceman.pos.y += move\n if ScancodeA.down: scene.spaceman.pos.x -= move\n if ScancodeD.down: scene.spaceman.pos.x += move\n\n" }, { "path": "demos/demo16/README.md", "content": "Nimgame 2: Demo 16\n==================\n\nParallax demo. Demonstrates parallax effect.\n\n![Screenshot](demo16.png)\n\n" }, { "path": "demos/demo16/demo16.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/settings,\n mainscene\n\ngame = newGame()\nif game.init(w = 640, h = 480, title = \"Nimgame 2: Demo 16 (Parallax)\"):\n showInfo = true\n game.scene = newMainScene()\n game.run()\n\n" }, { "path": "demos/demo16/mainscene.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/entity,\n nimgame2/texturegraphic,\n nimgame2/input,\n nimgame2/scene,\n nimgame2/settings,\n nimgame2/types\n\n\ntype\n MainScene = ref object of Scene\n spacemanG: TextureGraphic\n p0125, p025, p05, p1: Entity\n\n\nproc init*(scene: MainScene) =\n Scene(scene).init()\n\n # Graphics\n scene.spacemanG = newTextureGraphic()\n discard scene.spacemanG.load(\"../assets/gfx/spaceman.png\")\n\n # Entities\n scene.camera = newEntity()\n scene.camera.pos = game.size / 2\n\n scene.p0125 = newEntity()\n scene.p0125.parent = scene.camera\n scene.p0125.graphic = scene.spacemanG\n scene.p0125.centrify()\n scene.p0125.pos = game.size / 2\n scene.p0125.pos.y -= 150\n scene.p0125.parallax = 0.125\n\n scene.p025 = newEntity()\n scene.p025.parent = scene.camera\n scene.p025.graphic = scene.spacemanG\n scene.p025.centrify()\n scene.p025.pos = game.size / 2\n scene.p025.pos.y -= 100\n scene.p025.parallax = 0.25\n\n scene.p05 = newEntity()\n scene.p05.parent = scene.camera\n scene.p05.graphic = scene.spacemanG\n scene.p05.centrify()\n scene.p05.pos = game.size / 2\n scene.p05.pos.y -= 50\n scene.p05.parallax = 0.5\n\n scene.p1 = newEntity()\n scene.p1.parent = scene.camera\n scene.p1.graphic = scene.spacemanG\n scene.p1.centrify()\n scene.p1.pos = game.size / 2\n\n scene.cameraBond = scene.p1\n\n # add to scene\n scene.add(scene.p1)\n scene.add(scene.p05)\n scene.add(scene.p025)\n scene.add(scene.p0125)\n\n\nproc free*(scene: MainScene) =\n scene.spacemanG.free()\n\n\nproc newMainScene*(): MainScene =\n new result, free\n result.init()\n\n\nmethod event*(scene: MainScene, event: Event) =\n scene.eventScene(event)\n if event.kind == KeyDown:\n case event.key.keysym.sym:\n of K_Escape:\n gameRunning = false\n of K_Space:\n colliderOutline = not colliderOutline\n else: discard\n\n\nmethod render*(scene: MainScene) =\n scene.renderScene()\n\n\nmethod update*(scene: MainScene, elapsed: float) =\n scene.updateScene(elapsed)\n scene.camera.pos = mouse.abs - Coord(game.size / 2)\n\n" }, { "path": "demos/demo17/README.md", "content": "Nimgame 2: Demo 17\n==================\n\nFirst GUI demo. Demonstrates buttons and text field usage.\n\n![Screenshot](demo17.png)\n\n" }, { "path": "demos/demo17/btnCircle.nim", "content": "import\n nimgame2/graphic,\n nimgame2/input,\n nimgame2/gui/widget,\n nimgame2/gui/button\n\n\ntype\n CircleButton* = ref object of GuiButton\n\n\nproc init*(btn: CircleButton, graphic: Graphic) =\n GuiButton(btn).init(graphic, circle = true)\n\n\nproc newCircleButton*(graphic: Graphic): CircleButton =\n new result\n result.init(graphic)\n\n\nmethod onClick*(btn: CircleButton, mb: MouseButton) =\n echo \"clicked circle button, toggled \" & (if btn.toggled: \"on\" else: \"off\")\n\n" }, { "path": "demos/demo17/btnSquare.nim", "content": "import\n nimgame2/graphic,\n nimgame2/input,\n nimgame2/gui/button\n\n\ntype\n SquareButton* = ref object of GuiButton\n\n\nproc init*(btn: SquareButton, graphic: Graphic, image: Graphic = nil) =\n GuiButton(btn).init(graphic, image)\n\n\nproc newSquareButton*(graphic: Graphic, image: Graphic = nil): SquareButton =\n new result\n result.init(graphic, image)\n\n\nmethod onClick*(btn: SquareButton, mb: MouseButton) =\n echo \"clicked square button\"\n\n" }, { "path": "demos/demo17/demo17.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/settings,\n mainscene\n\ngame = newGame()\nif game.init(w = 640, h = 480, title = \"Nimgame 2: Demo 17 (GUI)\"):\n showInfo = true\n game.scene = newMainScene()\n game.run()\n\n" }, { "path": "demos/demo17/mainscene.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/draw,\n nimgame2/entity,\n nimgame2/texturegraphic,\n nimgame2/input,\n nimgame2/mosaic,\n nimgame2/scene,\n nimgame2/settings,\n nimgame2/truetypefont,\n nimgame2/types,\n nimgame2/gui/widget,\n nimgame2/gui/radio,\n nimgame2/gui/textinput,\n nimgame2/gui/progressbar,\n btnSquare, btnCircle\n\n\ntype\n MainScene = ref object of Scene\n btnSquareG, btnCircleG, iconX, btnMosaicG, inputG: TextureGraphic\n btnsRadio: array[3, GuiRadioButton]\n radioGroup: GuiRadioGroup\n btnSquare, btnMosaic: SquareButton\n btnCircle: CircleButton\n textInput: GuiTextInput\n progressBar: GuiProgressBar\n font: TrueTypeFont\n\n\nproc init*(scene: MainScene) =\n Scene(scene).init()\n\n # Graphics\n scene.btnSquareG = newTextureGraphic()\n discard scene.btnSquareG.load(\"../assets/gfx/button_square.png\")\n scene.btnCircleG = newTextureGraphic()\n discard scene.btnCircleG.load(\"../assets/gfx/button_circle.png\")\n scene.iconX = newTextureGraphic()\n discard scene.iconX.load(\"../assets/gfx/icon_x.png\")\n let mosaic = newMosaic(\"../assets/gfx/button_square.png\", (8, 8))\n scene.btnMosaicG = newTextureGraphic()\n discard scene.btnMosaicG.assignTexture mosaic.render(\n patternStretchBorder(4, 2))\n\n # Square Button\n scene.btnSquare = newSquareButton(scene.btnSquareG, scene.iconX)\n scene.btnSquare.mbAllow.set(MouseButton.right)\n scene.btnSquare.pos = (100, 100)\n # Circle Button\n scene.btnCircle = newCircleButton(scene.btnCircleG)\n scene.btnCircle.pos = (150, 100)\n scene.btnCircle.toggle = true\n # Mosaic Button\n scene.btnMosaic = newSquareButton(scene.btnMosaicG)\n scene.btnMosaic.pos = (200, 100)\n\n # Text Input\n scene.font = newTrueTypeFont()\n discard scene.font.load(\"../assets/fnt/FSEX300.ttf\", 16)\n let inputmosaic = newMosaic(\"../assets/gfx/text_input.png\", (8, 8))\n scene.inputG = newTextureGraphic()\n discard scene.inputG.assignTexture inputmosaic.render(\n patternStretchBorder(16, 1))\n scene.textInput = newGuiTextInput(scene.inputG, scene.font)\n scene.textInput.pos = (100, 150)\n scene.textInput.text.limit = 16\n\n # Radio Button\n scene.radioGroup = newGuiRadioGroup()\n scene.radioGroup.pos = (100, 200)\n for i in 0..scene.btnsRadio.high:\n scene.btnsRadio[i] = newGuiRadioButton(\n scene.radioGroup, scene.btnCircleG, circle = true)\n scene.btnsRadio[i].pos = (i.float * 50.0, 0.0)\n scene.btnsRadio[0].toggled = true\n\n # Progress Bar\n scene.progressBar = newProgressBar((200, 50), 0xFF0000FF'u32, 0x00FF00FF'u32,\n scene.font)\n scene.progressBar.min = 0\n scene.progressBar.max = 100\n scene.progressBar.value = 0\n scene.progressBar.direction = Direction.leftRight\n scene.progressBar.outline = (1, 1)\n scene.progressBar.pos = (100, 250)\n\n # add to scene\n scene.add(scene.progressBar)\n scene.add(scene.radioGroup)\n for b in scene.btnsRadio:\n scene.add(b)\n scene.add(scene.textInput)\n scene.add(scene.btnMosaic)\n scene.add(scene.btnSquare)\n scene.add(scene.btnCircle)\n\n\nproc free*(scene: MainScene) =\n scene.inputG.free()\n scene.btnMosaicG.free()\n scene.btnSquareG.free()\n scene.btnCircleG.free()\n scene.iconX.free()\n\n\nproc newMainScene*(): MainScene =\n new result, free\n result.init()\n\n\nmethod event*(scene: MainScene, event: Event) =\n scene.eventScene(event)\n if event.kind == KeyDown:\n case event.key.keysym.sym:\n of K_Escape:\n gameRunning = false\n of K_Space:\n colliderOutline = not colliderOutline\n else: discard\n\n\nmethod render*(scene: MainScene) =\n scene.renderScene()\n discard box((4, 60), (220, 76), 0x000000CC'u32)\n discard string(\n (8, 64), \"Space - toggle collider outlines\", 0xFFFFFFFF'u32)\n\n\nmethod update*(scene: MainScene, elapsed: float) =\n scene.updateScene(elapsed)\n\n # progressBar\n if scene.progressBar.value < scene.progressBar.max:\n scene.progressBar.value += 10 * elapsed\n if scene.progressBar.value > scene.progressBar.max:\n scene.progressBar.value = scene.progressBar.max\n\n\n" }, { "path": "demos/demo18/README.md", "content": "Nimgame 2: Demo 18\n==================\n\nIndexedImage. Demonstrates palette swapping in indexed images.\n\n![Screenshot](demo18.png)\n\n" }, { "path": "demos/demo18/demo18.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/settings,\n mainscene\n\ngame = newGame()\nif game.init(w = 320, h = 240, title = \"Nimgame 2: Demo 18 (IndexedImage)\"):\n game.windowSize = (640, 480)\n showInfo = true\n game.scene = newMainScene()\n game.run()\n\n" }, { "path": "demos/demo18/mainscene.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/draw,\n nimgame2/entity,\n nimgame2/texturegraphic,\n nimgame2/input,\n nimgame2/indexedimage,\n nimgame2/scene,\n nimgame2/settings,\n nimgame2/types\n\n\ntype\n MainScene = ref object of Scene\n idximg: IndexedImage\n knightG: TextureGraphic\n knight: Entity\n\n\nproc init*(scene: MainScene) =\n Scene(scene).init()\n\n scene.idximg = newIndexedImage(\"../assets/gfx/knight.gif\")\n\n scene.knightG = newTextureGraphic()\n discard scene.knightG.assignTexture scene.idximg.render()\n\n scene.knight = newEntity()\n scene.knight.graphic = scene.knightG\n scene.knight.pos = (128, 128)\n\n # add to scene\n scene.add(scene.knight)\n\n\nproc free*(scene: MainScene) =\n scene.knightG.free()\n\n\nproc newMainScene*(): MainScene =\n new result, free\n result.init()\n\n\nmethod event*(scene: MainScene, event: Event) =\n scene.eventScene(event)\n if event.kind == KeyDown:\n case event.key.keysym.sym:\n of K_Escape:\n gameRunning = false\n else: discard\n\n\nmethod render*(scene: MainScene) =\n scene.renderScene()\n discard box((4, 60), (220, 76), 0x000000CC'u32)\n discard string(\n (8, 64), \"QWER - increase RGBA values (1st color)\", 0xFFFFFFFF'u32)\n discard string(\n (8, 72), \"ASDF - decrease RGBA values (1st color)\", 0xFFFFFFFF'u32)\n discard string(\n (8, 80), \"TYUI - increase RGBA values (2nd color)\", 0xFFFFFFFF'u32)\n discard string(\n (8, 88), \"GHJK - decrease RGBA values (2nd color)\", 0xFFFFFFFF'u32)\n discard string(\n (8, 96), \"1st: \" & $scene.idximg.palette[3], 0xFFFFFFFF'u32)\n discard string(\n (8, 104), \"2nd: \" & $scene.idximg.palette[11], 0xFFFFFFFF'u32)\n\n\nconst\n Step = 15\n\n\nmethod update*(scene: MainScene, elapsed: float) =\n scene.updateScene(elapsed)\n let palette = scene.idximg.palette\n var\n upd = false\n color1 = palette[3]\n color2 = palette[11]\n\n # color1\n if ScancodeQ.pressed:\n color1.r = clamp(color1.r.int + Step, 0, 255).uint8\n upd = true\n if ScancodeW.pressed:\n color1.g = clamp(color1.g.int + Step, 0, 255).uint8\n upd = true\n if ScancodeE.pressed:\n color1.b = clamp(color1.b.int + Step, 0, 255).uint8\n upd = true\n if ScancodeR.pressed:\n color1.a = clamp(color1.a.int + Step, 0, 255).uint8\n upd = true\n if ScancodeA.pressed:\n color1.r = clamp(color1.r.int - Step, 0, 255).uint8\n upd = true\n if ScancodeS.pressed:\n color1.g = clamp(color1.g.int - Step, 0, 255).uint8\n upd = true\n if ScancodeD.pressed:\n color1.b = clamp(color1.b.int - Step, 0, 255).uint8\n upd = true\n if ScancodeF.pressed:\n color1.a = clamp(color1.a.int - Step, 0, 255).uint8\n upd = true\n\n # color2\n if ScancodeT.pressed:\n color2.r = clamp(color2.r.int + Step, 0, 255).uint8\n upd = true\n if ScancodeY.pressed:\n color2.g = clamp(color2.g.int + Step, 0, 255).uint8\n upd = true\n if ScancodeU.pressed:\n color2.b = clamp(color2.b.int + Step, 0, 255).uint8\n upd = true\n if ScancodeI.pressed:\n color2.a = clamp(color2.a.int + Step, 0, 255).uint8\n upd = true\n if ScancodeG.pressed:\n color2.r = clamp(color2.r.int - Step, 0, 255).uint8\n upd = true\n if ScancodeH.pressed:\n color2.g = clamp(color2.g.int - Step, 0, 255).uint8\n upd = true\n if ScancodeJ.pressed:\n color2.b = clamp(color2.b.int - Step, 0, 255).uint8\n upd = true\n if ScancodeK.pressed:\n color2.a = clamp(color2.a.int - Step, 0, 255).uint8\n upd = true\n\n if upd:\n scene.idximg.palette[3] = color1\n scene.idximg.palette[11] = color2\n discard scene.knightG.assignTexture(scene.idximg.render())\n\n" }, { "path": "demos/demo19/README.md", "content": "Nimgame 2: Demo 19\n==================\n\nPerspectiveImage. Demonstrates perspective transformations.\n\n![Screenshot](demo19.png)\n\n" }, { "path": "demos/demo19/demo19.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/settings,\n mainscene\n\ngame = newGame()\nif game.init(w = 640, h = 480, title = \"Nimgame 2: Demo 19 (PerspectiveImage)\"):\n showInfo = true\n game.scene = newMainScene()\n game.run()\n\n" }, { "path": "demos/demo19/mainscene.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/entity,\n nimgame2/texturegraphic,\n nimgame2/input,\n nimgame2/perspectiveimage,\n nimgame2/scene,\n nimgame2/settings,\n nimgame2/types\n\n\nconst\n GraphicCount = 17\n Positions: array[GraphicCount, Coord] = [\n (125.0, 125.0), (275, 125), (375, 125), (475, 125), (575, 125),\n (75, 275), (175, 275), (275, 275), (375, 275), (475, 275), (575, 275),\n (75, 425), (175, 425), (275, 425), (375, 425), (475, 400), (575, 425),\n ]\n\n\ntype\n MainScene = ref object of Scene\n pimg: PerspectiveImage\n graphics: array[GraphicCount, TextureGraphic]\n entities: array[GraphicCount, Entity]\n\n\nproc init*(scene: MainScene) =\n Scene(scene).init()\n\n scene.pimg = newPerspectiveImage(\"../assets/gfx/grid.png\")\n\n # graphics\n for i in 0..scene.graphics.high:\n scene.graphics[i] = newTextureGraphic()\n\n discard scene.graphics[0].assignTexture(scene.pimg.render(\n pdHor, 0, 0))\n discard scene.graphics[1].assignTexture(scene.pimg.render(\n pdHor, 96, 32))\n discard scene.graphics[2].assignTexture(scene.pimg.render(\n pdHor, 32, 96))\n discard scene.graphics[3].assignTexture(scene.pimg.render(\n pdHor, 64, 32, 32))\n discard scene.graphics[4].assignTexture(scene.pimg.render(\n pdHor, 32, 64, 32))\n discard scene.graphics[5].assignTexture(scene.pimg.render(\n pdVer, 96, 32))\n discard scene.graphics[6].assignTexture(scene.pimg.render(\n pdVer, 64, 32, 32))\n discard scene.graphics[7].assignTexture(scene.pimg.render(\n pdHor, 64, 32, shift = 0.0))\n discard scene.graphics[8].assignTexture(scene.pimg.render(\n pdHor, 32, 64, shift = 1.0))\n discard scene.graphics[9].assignTexture(scene.pimg.render(\n pdHor, 64, 32, shift = 0.25))\n discard scene.graphics[10].assignTexture(scene.pimg.render(\n pdHor, 32, 64, shift = 0.75))\n discard scene.graphics[11].assignTexture(scene.pimg.render(\n pdVer, 32, 96))\n discard scene.graphics[12].assignTexture(scene.pimg.render(\n pdVer, 32, 64, 32))\n discard scene.graphics[13].assignTexture(scene.pimg.render(\n pdVer, 64, 32, shift = 0.0))\n discard scene.graphics[14].assignTexture(scene.pimg.render(\n pdVer, 64, 32, shift = 1.0))\n discard scene.graphics[15].assignTexture(scene.pimg.render(\n pdVer, 64, 32, shift = 0.25))\n discard scene.graphics[16].assignTexture(scene.pimg.render(\n pdVer, 32, 64, shift = 0.75))\n\n # entities\n for i in 0..scene.entities.high:\n scene.entities[i] = newEntity()\n scene.entities[i].graphic = scene.graphics[i]\n scene.entities[i].centrify()\n scene.entities[i].pos = Positions[i]\n\n # add to scene\n for entity in scene.entities:\n scene.add(entity)\n\n\nproc free*(scene: MainScene) =\n scene.pimg.free()\n for graphic in scene.graphics:\n graphic.free()\n\n\nproc newMainScene*(): MainScene =\n new result, free\n result.init()\n\n\nmethod event*(scene: MainScene, event: Event) =\n scene.eventScene(event)\n if event.kind == KeyDown:\n case event.key.keysym.sym:\n of K_Escape:\n gameRunning = false\n else: discard\n\n\nmethod render*(scene: MainScene) =\n scene.renderScene()\n\n" }, { "path": "demos/demo2/README.md", "content": "Nimgame 2: Demo 2\n=================\n\nGraphic demo.\n\nDemonstrates color and alpha modifiers, blending modes, and scaling.\n\n![Screenshot](demo2.png)\n\n" }, { "path": "demos/demo2/demo2.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/settings,\n mainscene\n\ngame = newGame()\nif game.init(w = 640, h = 480, title = \"Nimgame 2: Demo 2 (Graphic)\",\n scaleQuality = 0):\n showInfo = true\n game.scene = newMainScene()\n game.run()\n\n" }, { "path": "demos/demo2/earth.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/entity\n\ntype\n Earth* = ref object of Entity\n\n\nproc init*(entity: Earth) =\n entity.initEntity()\n entity.pos.x = 128.0\n entity.pos.y = 96.0\n\n\nproc newEarth*(): Earth =\n result = new Earth\n result.init()\n\n" }, { "path": "demos/demo2/mainscene.nim", "content": "import\n math,\n nimgame2/nimgame,\n nimgame2/draw,\n nimgame2/entity,\n nimgame2/texturegraphic,\n nimgame2/input,\n nimgame2/scene,\n nimgame2/settings,\n nimgame2/types,\n earth, spaceman\n\n\ntype\n MainScene = ref object of Scene\n earthG, spacemanG: TextureGraphic\n e: Earth\n s: Spaceman\n\n\nproc init*(scene: MainScene) =\n Scene(scene).init()\n # Earth\n scene.e = newEarth()\n scene.earthG = newTextureGraphic()\n discard scene.earthG.load(\"../assets/gfx/earth.png\")\n scene.e.graphic = scene.earthG\n # Spaceman\n scene.s = newSpaceman()\n scene.spacemanG = newTextureGraphic()\n discard scene.spacemanG.load(\"../assets/gfx/spaceman.png\")\n scene.s.graphic = scene.spacemanG\n\n # add to scene\n scene.add(scene.s)\n scene.add(scene.e)\n\n\nproc free*(scene: MainScene) =\n scene.earthG.free\n scene.spacemanG.free\n\n\nproc newMainScene*(): MainScene =\n new result, free\n result.init()\n\n\nproc changeBlendMod(scene: MainScene, increase = true) =\n # get blend mod\n var b = TextureGraphic(scene.s.graphic).blendMod\n # change blend mod\n if increase:\n if b.int == 0:\n b = Blend(1)\n elif b < Blend.high:\n b = Blend(b.int shl 1)\n else: # decrease\n if b.int > 0:\n b = Blend(b.int shr 1)\n # set blend mod\n TextureGraphic(scene.s.graphic).blendMod = b\n\n\nconst\n ScaleMax = 3\n ScaleMin = 0.5\n ScaleMod = 0.25\n\nproc changeResolution(scene: MainScene, increase = true) =\n # get current scale\n var scale = game.scale\n # change scale\n if increase:\n if scale.x < ScaleMax:\n scale.x += ScaleMod\n scale.y += ScaleMod\n else: # decrease\n if scale.x > ScaleMin:\n scale.x -= ScaleMod\n scale.y -= ScaleMod\n # set resolution\n game.windowSize = Dim(Coord(game.size) * scale)\n\n\nmethod event*(scene: MainScene, event: Event) =\n if event.kind == KeyDown:\n case event.key.keysym.sym:\n of K_Escape:\n gameRunning = false\n of K_T:\n scene.changeBlendMod()\n of K_G:\n scene.changeBlendMod(false)\n of K_Y:\n scene.changeResolution()\n of K_H:\n scene.changeResolution(false)\n else: discard\n\n\nmethod render*(scene: MainScene) =\n scene.renderScene()\n let c = TextureGraphic(scene.s.graphic).colorMod\n let res = game.windowSize\n let scale: Coord = (game.scale.x.round(2), game.scale.y.round(2))\n discard box((4, 60), (220, 124), 0x000000CC'u32)\n discard string(\n (8, 64), \"Q/A - red mod: \" & $c.r.int, 0xFF0000FF'u32)\n discard string(\n (8, 72), \"W/S - green mod: \" & $c.g.int, 0xFF0000FF'u32)\n discard string(\n (8, 80), \"E/D - blue mod: \" & $c.b.int, 0xFF0000FF'u32)\n discard string(\n (8, 88), \"R/F - alpha mod: \" &\n $TextureGraphic(scene.s.graphic).alphaMod.int, 0xFF0000FF'u32)\n discard string(\n (8, 96), \"T/G - blend mod: \" &\n $TextureGraphic(scene.s.graphic).blendMod, 0xFF0000FF'u32)\n discard string(\n (8, 104), \"Y/H - resolution: \" & $res.w & \"x\" & $res.h, 0xFF0000FF'u32)\n discard string(\n (8, 112), \"Scale: \" & $scale.x & \"x\" & $scale.y, 0xFF0000FF'u32)\n\n\ntype\n ColorElement = enum\n ceR, ceG, ceB\n\n\nproc changeColorMod(scene: MainScene, elem: ColorElement, val: int) =\n var color = TextureGraphic(scene.s.graphic).colorMod\n # Get color element\n var e = int(case elem:\n of ceR: color.r\n of ceG: color.g\n of ceB: color.b)\n # Change color element\n inc(e, val)\n # Correct value\n if e < 0x00: e = 0x00\n elif e > 0xFF: e = 0xFF\n # Set color mod\n case elem:\n of ceR: color.r = e.uint8\n of ceG: color.g = e.uint8\n of ceB: color.b = e.uint8\n TextureGraphic(scene.s.graphic).colorMod = color\n\n\nproc changeAlphaMod(scene: MainScene, val: int) =\n # Get alpha mod\n var a = TextureGraphic(scene.s.graphic).alphaMod.int\n # Change alpha mod\n inc(a, val)\n # Correct value\n if a < 0x00: a = 0x00\n elif a > 0xFF: a = 0xFF\n # Set alpha mod\n TextureGraphic(scene.s.graphic).alphaMod = a.uint8\n\n\nmethod update*(scene: MainScene, elapsed: float) =\n let val = int(0xFF * elapsed)\n scene.updateScene(elapsed)\n if ScancodeQ.down: scene.changeColorMod(ceR, val)\n if ScancodeA.down: scene.changeColorMod(ceR, -val)\n if ScancodeW.down: scene.changeColorMod(ceG, val)\n if ScancodeS.down: scene.changeColorMod(ceG, -val)\n if ScancodeE.down: scene.changeColorMod(ceB, val)\n if ScancodeD.down: scene.changeColorMod(ceB, -val)\n if ScancodeR.down: scene.changeAlphaMod(val)\n if ScancodeF.down: scene.changeAlphaMod(-val)\n\n" }, { "path": "demos/demo2/spaceman.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/entity\n\ntype\n Spaceman* = ref object of Entity\n\n\nproc init*(entity: Spaceman) =\n entity.initEntity()\n entity.pos.x = 200.0\n entity.pos.y = 64.0\n\n\nproc newSpaceman*(): Spaceman =\n result = new Spaceman\n result.init()\n\n" }, { "path": "demos/demo20/README.md", "content": "Nimgame 2: Demo 20\n==================\n\nTextureAtlas. Demonstrates texture atlas loading and access.\n\n![Screenshot](demo20.png)\n\n" }, { "path": "demos/demo20/demo20.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/settings,\n mainscene\n\ngame = newGame()\nif game.init(w = 320, h = 240, title = \"Nimgame 2: Demo 20 (TextureAtlas)\"):\n showInfo = true\n game.windowSize = (640, 480)\n game.scene = newMainScene()\n game.run()\n\n" }, { "path": "demos/demo20/mainscene.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/entity,\n nimgame2/gui/button,\n nimgame2/texturegraphic,\n nimgame2/textureatlas,\n nimgame2/input,\n nimgame2/scene,\n nimgame2/settings,\n nimgame2/types\n\n\ntype\n MainScene = ref object of Scene\n atlas: TextureAtlas\n\n\nproc init*(scene: MainScene) =\n Scene(scene).init()\n\n scene.atlas = newTextureAtlas(\"../assets/gfx/atlas.png\",\n \"../assets/csv/atlas.csv\")\n\n let\n eSpaceman = newEntity()\n eGradient = newEntity()\n eButton = newGuiButton(scene.atlas[\"button\"])\n eSprite = newEntity()\n\n eSpaceman.graphic = scene.atlas[\"spaceman\"]\n eSpaceman.pos = (50.0, 100.0)\n\n eGradient.graphic = scene.atlas[\"gradient\"]\n eGradient.pos = (150.0, 100.0)\n\n eButton.pos = (200.0, 100.0)\n\n eSprite.graphic = scene.atlas[\"sprite\"]\n eSprite.initSprite((32, 32), (0, 32), (1, 1))\n discard eSprite.addAnimation(\"play\", toSeq(0..3), 1/4)\n eSprite.play(\"play\")\n eSprite.pos = (200.0, 150.0)\n\n scene.add(eSpaceman)\n scene.add(eGradient)\n scene.add(eButton)\n scene.add(eSprite)\n\n\nproc free*(scene: MainScene) =\n scene.atlas.free()\n\n\nproc newMainScene*(): MainScene =\n new result, free\n result.init()\n\n\nmethod event*(scene: MainScene, event: Event) =\n scene.eventScene(event)\n if event.kind == KeyDown:\n case event.key.keysym.sym:\n of K_Escape:\n gameRunning = false\n else: discard\n\n\nmethod render*(scene: MainScene) =\n scene.renderScene()\n\n" }, { "path": "demos/demo21/README.md", "content": "Nimgame 2: Demo 21\n==================\n\nJoysticks. Demonstrates joystick input handling.\n\n![Screenshot](demo21.png)\n\n" }, { "path": "demos/demo21/demo21.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/settings,\n mainscene\n\ngame = newGame()\nif game.init(w = 640, h = 480, title = \"Nimgame 2: Demo 21 (Joysticks)\"):\n showInfo = true\n game.scene = newMainScene()\n game.run()\n\n" }, { "path": "demos/demo21/joypoint.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/entity,\n nimgame2/textgraphic,\n nimgame2/texturegraphic,\n nimgame2/font,\n nimgame2/bitmapfont,\n nimgame2/input,\n nimgame2/types\n\n\ntype\n JoyPoint* = ref object of Entity\n joy: int\n label: TextGraphic\n\n\nproc init(jp: JoyPoint, id: int) =\n jp.initEntity()\n jp.joy = id\n jp.graphic = newTextureGraphic(\"../assets/gfx/target.png\")\n jp.centrify()\n jp.pos = game.size / 2\n # label\n let font = newBitmapFont()\n discard font.load(\"../assets/fnt/default8x16.png\", (8, 16))\n jp.label = newTextGraphic(font)\n jp.label.lines = [$id]\n\n\nproc newJoyPoint*(joystick: int): JoyPoint =\n new result\n result.init(joystick)\n\n\nmethod render*(jp: JoyPoint) =\n jp.renderEntity()\n jp.label.draw(\n jp.absPos + jp.center - Coord(jp.label.dim / 2) + (1.0, 1.0),\n jp.absRot,\n jp.absScale,\n jp.center,\n jp.flip)\n\n\nconst Speed = 100\n\nmethod update*(jp: JoyPoint, elapsed: float) =\n let move = Speed * elapsed / JoyAxis.high.float\n jp.updateEntity(elapsed)\n jp.pos.x += jp.joy.joyAxis(0).float * move\n jp.pos.x = clamp(jp.pos.x, 0.0, game.size.w.float)\n jp.pos.y += jp.joy.joyAxis(1).float * move\n jp.pos.y = clamp(jp.pos.y, 0.0, game.size.h.float)\n\n" }, { "path": "demos/demo21/mainscene.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/draw,\n nimgame2/entity,\n nimgame2/texturegraphic,\n nimgame2/input,\n nimgame2/scene,\n nimgame2/settings,\n nimgame2/types,\n joypoint\n\n\ntype\n MainScene = ref object of Scene\n joypoints: seq[JoyPoint]\n\n\nproc init*(scene: MainScene) =\n Scene(scene).init()\n scene.joypoints = @[]\n for i in 0..= game.size.w.float:\n entity.vel.x *= -1\n if entity.pos.y >= game.size.h.float:\n entity.vel.y *= -1\n\n\nproc init*(scene: MainScene) =\n Scene(scene).init()\n # Movie\n scene.movie = newMpegGraphic(\"video.mpg\")\n scene.movie.loop = true\n scene.e = newEntity()\n scene.e.graphic = scene.movie\n scene.e.physics = moviePhysics\n scene.e.pos.x = rand(game.size.w).float\n scene.e.pos.y = rand(game.size.h).float\n scene.e.vel.x = rand(10.0..100.0) * randSign().float\n scene.e.vel.y = rand(10.0..100.0) * randSign().float\n scene.e.centrify()\n scene.e.rotVel = rand(10.0..60.0) * randSign().float\n\n # add to scene\n scene.add(scene.e)\n\n\nproc free*(scene: MainScene) =\n scene.movie.free()\n\n\nproc newMainScene*(): MainScene =\n new result, free\n result.init()\n\n\nmethod event*(scene: MainScene, event: Event) =\n if event.kind == KeyDown:\n case event.key.keysym.sym:\n of K_Escape:\n gameRunning = false\n else: discard\n\n\nmethod render*(scene: MainScene) =\n scene.renderScene()\n discard box((4, 60), (220, 124), 0x000000CC'u32)\n discard string(\n (8, 64), \"Enter - play\", 0xFF0000FF'u32)\n discard string(\n (8, 72), \"Space - pause\", 0xFF0000FF'u32)\n discard string(\n (8, 80), \"Backspace - stop\", 0xFF0000FF'u32)\n discard string(\n (8, 88), \"R - Rewind\", 0xFF0000FF'u32)\n discard string(\n (8, 96), \"Up/Down - volume: \" & $scene.movie.volume, 0xFF0000FF'u32)\n discard string(\n (8, 104), \"Right - skip 5s\", 0xFF0000FF'u32)\n discard string(\n (8, 112), \"Time: \" & scene.movie.currentTime.formatFloat(precision = 3) &\n \"s of \" & scene.movie.totalTime.formatFloat(precision = 3) & \"s\", 0xFF0000FF'u32)\n\n\nmethod update*(scene: MainScene, elapsed: float) =\n scene.updateScene(elapsed)\n if ScancodeReturn.pressed: scene.movie.play()\n if ScancodeSpace.pressed: scene.movie.pause()\n if ScancodeBackspace.pressed: scene.movie.stop()\n if ScancodeR.pressed: scene.movie.rewind()\n if ScancodeUp.pressed: scene.movie.volume =\n (scene.movie.volume + 10).clamp(0, 100)\n if ScancodeDown.pressed: scene.movie.volume =\n (scene.movie.volume - 10).clamp(0, 100)\n if ScancodeRight.pressed: scene.movie.skip(5.0)\n\n" }, { "path": "demos/demo23/README.md", "content": "Nimgame 2: Demo 23\n==================\n\nTransform demo by [CodeDoes](https://github.com/CodeDoes).\n\n![Screenshot](demo23.png)\n\n" }, { "path": "demos/demo23/demo23.nim", "content": "import\n nimgame2 / [\n nimgame, settings\n ],\n mainscene\n\n\ngame = newGame()\nif game.init(640, 480, \"Nimgame 2: Demo 22 (Transform)\"):\n game.scene = newMainScene()\n settings.updateInterval = 1000\n settings.showInfo = true\n game.run()\n\n" }, { "path": "demos/demo23/mainscene.nim", "content": "import\n nimgame2 / [\n truetypefont, textgraphic, entity,\n nimgame, scene, types,\n graphic, input, settings],\n nimgame2 / gui / widget,\n private / [\n circle_graphic,\n frame]\n\n\ntype\n MainScene* = ref object of Scene\n font*: TrueTypeFont\n\n\nproc newCircleEntity*(): Entity =\n var cgraphic = newCircleGraphic()\n cgraphic.radius = 4.0\n cgraphic.draw_border = false\n\n result = newEntity()\n result.graphic = cgraphic\n result.centrify()\n\n\nproc createRotScaleTestEnts*(\n scene: MainScene, text: string,\n pos: var Coord, rot: Angle = 0.0, scale: Scale = 1.0) =\n var\n textEnt = newEntity()\n textgraphic = newTextGraphic(scene.font)\n\n scene.add(textEnt)\n textEnt.graphic = textgraphic\n\n textgraphic.setText text\n\n textEnt.scale = scale\n textEnt.pos = pos + (textEnt.bottomleft * textEnt.absScale)\n textEnt.center += textEnt.bottomleft\n echo textEnt.pos\n # Want rel_pos before rotation\n pos.y = (textEnt.transform * textEnt.bottomleft).y\n textEnt.rot = rot * 90.0\n for p in textEnt.world_corners.items():\n var cent = newCircleEntity()\n scene.add(cent)\n cent.pos = p\n var frameEnt = newGuiWidget()\n scene.add(frameEnt)\n var fGraphic = newFrameGraphic()\n frameEnt.graphic = fGraphic\n fGraphic.draw_filled = false\n fGraphic.border_color = ColorRed\n fGraphic.rect.x = textEnt.topleft.x.cint\n fGraphic.rect.y = textEnt.topleft.y.cint\n fGraphic.rect.w = textEnt.dim.w.cint\n fGraphic.rect.h = textEnt.dim.h.cint\n frameEnt.logic = proc (entity: Entity, elapsed: float) =\n let color =\n if entity.GuiWidget.state.isFocused: ColorOrange\n else: ColorGreen\n entity.graphic.FrameGraphic.border_color = color\n\n frameEnt.center = textEnt.center\n frameEnt.pos = textEnt.pos\n frameEnt.rot = textEnt.rot\n frameEnt.scale = textEnt.scale\n var corners = newseq[Coord]()\n for c in frameEnt.corners:\n corners.add(c)\n frameEnt.collider = frameEnt.newPolyCollider(frameEnt.pos, corners)\n\n\nproc init*(scene: MainScene) =\n scene.Scene.init()\n scene.font = newTrueTypeFont()\n discard scene.font.load(\"../assets/fnt/FSEX300.ttf\", 32)\n\n var rel_pos: Coord = (0.0, 100.0)\n for scale in [0.8, 0.3, 0.4, 0.6, 0.7, 0.2]:\n createRotScaleTestEnts(scene, \"Scale Test\", rel_pos, scale = scale)\n\n for f in [0.8, 0.3, 0.4, 0.6, 0.7, 0.2]:\n createRotScaleTestEnts(scene, \"Rot Scale Test\", rel_pos, rot = f, scale = f)\n\n rel_pos = (400.0, 0.0)\n for rot in [0.8, 0.3, 0.4, 0.6, 0.7, 0.2]:\n createRotScaleTestEnts(scene, \"Rot Test\", rel_pos, rot = rot)\n\n\nproc newMainScene*(): MainScene =\n new result\n result.init()\n\n" }, { "path": "demos/demo23/private/border_fill_graphic.nim", "content": "import\n nimgame2 / [\n types, graphic, types\n ]\n\n\ntype\n BorderFillGraphic* = ref object of Graphic\n border_color*, fill_color*: Color\n # border_thickness*: float #NOTE can't set border thickness at the moment\n draw_border*, draw_filled*: bool\n\n\nproc initBorderFillGraphic*(self: BorderFillGraphic) =\n self.draw_border = true\n self.draw_filled = true\n self.fill_color = ColorPurple ## Traditional visual debugging color\n self.border_color = ColorPink\n # self.border_thickness = 1.0\n\n\nmethod draw*(graphic: BorderFillGraphic,\n pos: Coord = (0.0, 0.0),\n angle: Angle = 0.0,\n scale: Scale = 1.0,\n center: Coord = (0.0, 0.0),\n flip: Flip = Flip.none,\n region: Rect = Rect(x: 0, y: 0, w: 0, h: 0)) =\n raise newException(CatchableError, \"Can't use BorderFillGraphic draw method.\")\n\n\nmethod dim*(graphic: BorderFillGraphic): Dim =\n raise newException(CatchableError, \"Can't use BorderFillGraphic dim method.\")\n\n" }, { "path": "demos/demo23/private/circle_graphic.nim", "content": "import\n nimgame2 / [\n types, graphic, draw, utils\n ],\n border_fill_graphic\n\n\ntype\n CircleGraphic* = ref object of BorderFillGraphic\n radius*: float\n\n\nproc drawCircleGraphic*(self: CircleGraphic,\n pos: Coord = (0.0, 0.0),\n angle: Angle = 0.0,\n scale: Scale = 1.0,\n center: Coord = (0.0, 0.0),\n flip: Flip = Flip.none,\n region: Rect = Rect(x: 0, y: 0, w: 0, h: 0)) =\n let point: Coord = pos\n if self.draw_filled:\n discard circle(point, self.radius, self.fill_color, DrawMode.filled)\n if self.draw_border:\n discard circle(point, self.radius, self.border_color, DrawMode.default)\n\n\nmethod draw*(graphic: CircleGraphic,\n pos: Coord = (0.0, 0.0),\n angle: Angle = 0.0,\n scale: Scale = 1.0,\n center: Coord = (0.0, 0.0),\n flip: Flip = Flip.none,\n region: Rect = Rect(x: 0, y: 0, w: 0, h: 0)) =\n drawCircleGraphic(graphic, pos, angle, scale, center, flip, region)\n\n\nproc newCircleGraphic*(): CircleGraphic =\n new result\n result.initBorderFillGraphic()\n result.radius = 5.0\n\n\nmethod dim*(self: CircleGraphic): Dim =\n return (int self.radius * 2, int self.radius * 2)\n" }, { "path": "demos/demo23/private/frame.nim", "content": "import \n nimgame2 / [\n types, graphic, draw, utils\n ],\n border_fill_graphic\n\ntype\n FrameGraphic* = ref object of BorderFillGraphic\n rect*: Rect\n\n Bounds = tuple[a: Coord, b: Coord]\n\n AngledBounds* = ref object of RootObj\n bounds*: Bounds\n angle*: Angle\n center*: Coord\n\n\nproc points*(abounds: AngledBounds): auto {.inline.} =\n let\n a = abounds.bounds.a\n b = abounds.bounds.b\n center = abounds.center\n angle = abounds.angle\n\n template apply(coord: Coord): Coord =\n rotate(coord, center, angle)\n\n return @[\n apply(a),\n apply((b.x, a.y)),\n apply(b),\n apply((a.x, b.y))\n ]\n\n\nproc points*(graphic: FrameGraphic, pos: Coord, angle: Angle,\n scale: Scale, center: Coord): seq[Coord] =\n var\n abounds = new AngledBounds\n\n abounds.bounds = (a: -center * scale,\n b: (-center + graphic.dim.toCoord) * scale).Bounds\n abounds.angle = angle\n abounds.center = pos\n return abounds.points\n\n\nproc initFrameGraphic(graphic: FrameGraphic) =\n graphic.initBorderFillGraphic()\n graphic.rect= Rect(x: 0, y: 0, w: 0, h: 0)\n\n\nproc newFrameGraphic*(): FrameGraphic =\n new result\n result.initFrameGraphic()\n\n\nmethod dim*(self: FrameGraphic): Dim =\n (self.rect.w.int, self.rect.h.int)\n\n\nproc drawFrameGraphic*(self: FrameGraphic,\n pos: Coord,\n angle: Angle,\n scale: Scale,\n center: Coord,\n flip: Flip,\n region: Rect) =\n var points = self.points(pos,angle, scale,center)\n if self.draw_border:\n discard draw.polygon(points, self.border_color, DrawMode.default)\n if self.draw_filled:\n discard draw.polygon(points, self.fill_color, DrawMode.filled)\n\n\nmethod draw*(\n graphic: FrameGraphic,\n pos: Coord = (0.0, 0.0),\n angle: Angle = 0.0,\n scale: Scale = 1.0,\n center: Coord = (0.0, 0.0),\n flip: Flip = Flip.none,\n region: Rect = Rect(x: 0, y: 0, w: 0, h: 0)) =\n drawFrameGraphic(graphic, pos, angle, scale, center, flip, region)\n\n" }, { "path": "demos/demo3/README.md", "content": "Nimgame 2: Demo 3\n=================\n\nInput demo. Demonstrates keyboard and mouse input.\n\n![Screenshot](demo3.png)\n\n" }, { "path": "demos/demo3/demo3.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/settings,\n mainscene\n\ngame = newGame()\nif game.init(w = 640, h = 480, title = \"Nimgame 2: Demo 3 (Input & Physics)\"):\n showInfo = true\n game.scene = newMainScene()\n game.run()\n\n" }, { "path": "demos/demo3/mainscene.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/draw,\n nimgame2/entity,\n nimgame2/texturegraphic,\n nimgame2/input,\n nimgame2/scene,\n nimgame2/settings,\n nimgame2/types,\n spaceman\n\n\ntype\n MainScene = ref object of Scene\n spacemanG: TextureGraphic\n s: Spaceman\n\n\nproc spacemanPhysics(entity: Entity, elapsed: float) =\n defaultPhysics(entity, elapsed)\n if entity.pos.x.int < 0:\n entity.pos.x = 0\n entity.vel.x = 0\n if entity.pos.x.int > game.size.w:\n entity.pos.x = game.size.w.float\n entity.vel.x = 0\n if entity.pos.y.int < 0:\n entity.pos.y = 0\n entity.vel.y = 0\n if entity.pos.y.int > game.size.h:\n entity.pos.y = game.size.h.float\n entity.vel.y = 0\n\n\nproc init*(scene: MainScene) =\n Scene(scene).init()\n # Spaceman\n scene.s = newSpaceman()\n scene.spacemanG = newTextureGraphic()\n discard scene.spacemanG.load(\"../assets/gfx/spaceman.png\")\n scene.s.graphic = scene.spacemanG\n scene.s.physics = spacemanPhysics\n scene.s.centrify()\n scene.add(scene.s)\n # Mouse\n #discard mouseRelative(true)\n\nproc free*(scene: MainScene) =\n scene.spacemanG.free()\n\n\nproc newMainScene*(): MainScene =\n new result, free\n result.init()\n\n\nmethod event*(scene: MainScene, event: Event) =\n if event.kind == KeyDown:\n case event.key.keysym.sym:\n of K_Escape:\n gameRunning = false\n else: discard\n\n\nmethod render*(scene: MainScene) =\n # Draw line between the spaceman and the mouse position if LMB is pressed\n if MouseButton.left.down:\n discard line(scene.s.pos, mouse.abs, 0xFF0000FF'u32)\n\n scene.renderScene()\n\n var arrows: string = \"\"\n if ScancodeUp.down: arrows &= \"Up \"\n if ScancodeDown.down: arrows &= \"Down \"\n if ScancodeLeft.down: arrows &= \"Left \"\n if ScancodeRight.down: arrows &= \"Right\"\n\n var wsad: string = \"\"\n if ScancodeW.down: wsad &= \"W \"\n if ScancodeS.down: wsad &= \"S \"\n if ScancodeA.down: wsad &= \"A \"\n if ScancodeD.down: wsad &= \"D \"\n\n var mouse: string = \"Abs(\" & $mouse.abs.x.int & \":\" & $mouse.abs.y.int &\n \") Rel(\" & $mouse.rel.x.int & \":\" & $mouse.rel.y.int & \")\"\n\n var buttons: string = \"\"\n if MouseButton.left.down: buttons &= \"L \"\n if MouseButton.middle.down: buttons &= \"M \"\n if MouseButton.right.down: buttons &= \"R \"\n if MouseButton.x1.down: buttons &= \"X1 \"\n if MouseButton.x2.down: buttons &= \"X2 \"\n\n\n discard box((4, 60), (260, 100), 0xCC000000'u32)\n discard string(\n (8, 64), \"Arrows: \" & arrows, 0xFF0000FF'u32)\n discard string(\n (8, 72), \"WSAD: \" & wsad, 0xFF0000FF'u32)\n discard string(\n (8, 80), \"Mouse: \" & mouse, 0xFF0000FF'u32)\n discard string(\n (8, 88), \"Mouse buttons: \" & buttons, 0xFF0000FF'u32)\n discard string(\n (8, 96), \"Mouse wheel: \" & $mouseWheel, 0xFF0000FF'u32)\n\nconst\n Acc = 100.0\n\n\nmethod update*(scene: MainScene, elapsed: float) =\n scene.updateScene(elapsed)\n # Arrows and WSAD\n if ScancodeUp.down or ScancodeW.down: scene.s.vel.y -= Acc * elapsed\n if ScancodeDown.down or ScancodeS.down: scene.s.vel.y += Acc * elapsed\n if ScancodeLeft.down or ScancodeA.down: scene.s.vel.x -= Acc * elapsed\n if ScancodeRight.down or ScancodeD.down: scene.s.vel.x += Acc * elapsed\n # Mouse\n if MouseButton.left.down:\n var vector: Coord\n vector = (mouse.abs - scene.s.pos) * elapsed\n scene.s.vel += vector\n\n" }, { "path": "demos/demo3/spaceman.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/entity\n\ntype\n Spaceman* = ref object of Entity\n\n\nproc init*(entity: Spaceman) =\n entity.initEntity()\n entity.pos.x = game.size.w.float / 2\n entity.pos.y = game.size.h.float / 2\n entity.drg.x = 10.0\n entity.drg.y = 10.0\n\n\nproc newSpaceman*(): Spaceman =\n result = new Spaceman\n result.init()\n\n" }, { "path": "demos/demo4/README.md", "content": "Nimgame 2: Demo 4\n=================\n\nSprite demo. Demonstrates sprite animation.\n\n![Screenshot](demo4.png)\n\n" }, { "path": "demos/demo4/demo4.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/settings,\n mainscene\n\ngame = newGame()\nif game.init(w = 640, h = 480, title = \"Nimgame 2: Demo 4 (Sprite & Animation)\"):\n showInfo = true\n game.scene = newMainScene()\n game.run()\n\n" }, { "path": "demos/demo4/dwarf.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/entity\n\ntype\n Dwarf* = ref object of Entity\n\n\nproc init*(entity: Dwarf) =\n entity.initEntity()\n entity.centrify()\n entity.physics = defaultPhysics\n\n\nproc newDwarf*(): Dwarf =\n result = new Dwarf\n result.init()\n\n" }, { "path": "demos/demo4/mainscene.nim", "content": "import\n math,\n nimgame2/nimgame,\n nimgame2/draw,\n nimgame2/entity,\n nimgame2/texturegraphic,\n nimgame2/input,\n nimgame2/scene,\n nimgame2/settings,\n nimgame2/types,\n dwarf\n\n\ntype\n MainScene = ref object of Scene\n dG: TextureGraphic\n d: Dwarf\n\n\nconst Framerate = 1/12\n\n\nproc init*(scene: MainScene) =\n Scene(scene).init()\n # Dwarf\n scene.dG = newTextureGraphic()\n discard scene.dG.load(\"../assets/gfx/dwarf.png\")\n scene.d = newDwarf()\n scene.d.pos = (200, 100)\n scene.d.graphic = scene.dG\n scene.d.initSprite((24, 48))\n discard scene.d.addAnimation(\n \"down\", [0, 1, 2, 3, 4, 5], Framerate)\n discard scene.d.addAnimation(\n \"up\", [6, 7, 8, 9, 10, 11], Framerate)\n discard scene.d.addAnimation(\n \"left\", [12, 13, 14, 15, 16, 17], Framerate)\n discard scene.d.addAnimation(\n \"right\", [12, 13, 14, 15, 16, 17], Framerate, Flip.horizontal)\n scene.add(scene.d)\n\n\nproc free*(scene: MainScene) =\n scene.dG.free\n\n\nproc newMainScene*(): MainScene =\n new result, free\n result.init()\n\n\nmethod event*(scene: MainScene, event: Event) =\n if event.kind == KeyDown:\n case event.key.keysym.sym:\n of K_Escape:\n gameRunning = false\n else: discard\n\n\nmethod render*(scene: MainScene) =\n scene.renderScene()\n\n\nconst Speed = 50\n\n\nmethod update*(scene: MainScene, elapsed: float) =\n scene.updateScene(elapsed)\n\n # Controls and speed\n type Direction = enum none, down, up, left, right\n var direction =\n if ScancodeDown.down or ScancodeS.down: down\n elif ScancodeUp.down or ScancodeW.down: up\n elif ScancodeLeft.down or ScancodeA.down: left\n elif ScancodeRight.down or ScancodeD.down: right\n else: none\n\n case direction:\n of none:\n if not scene.d.sprite.playing:\n scene.d.vel = (0, 0)\n of down:\n if not scene.d.sprite.playing or\n (scene.d.currentAnimationName != \"down\"):\n scene.d.play(\"down\", 1)\n scene.d.vel = (0, Speed)\n of up:\n if not scene.d.sprite.playing or\n (scene.d.currentAnimationName != \"up\"):\n scene.d.play(\"up\", 1)\n scene.d.vel = (0, -Speed)\n of left:\n if not scene.d.sprite.playing or\n (scene.d.currentAnimationName != \"left\"):\n scene.d.play(\"left\", 1)\n scene.d.vel = (-Speed, 0)\n of right:\n if not scene.d.sprite.playing or\n (scene.d.currentAnimationName != \"right\"):\n scene.d.play(\"right\", 1)\n scene.d.vel = (Speed, 0)\n\n" }, { "path": "demos/demo5/README.md", "content": "Nimgame 2: Demo 5\n=================\n\nColliders demo. Demonstrates different colliders.\n\n![Screenshot](demo5.png)\n\n" }, { "path": "demos/demo5/cursor.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/entity,\n nimgame2/input\n\ntype\n Cursor* = ref object of Entity\n collidedWith*: seq[string]\n\n\nproc init*(entity: Cursor) =\n entity.initEntity()\n entity.tags.add(\"Cursor\")\n entity.pos = mouse.abs\n entity.collidedWith = @[]\n\n\nproc newCursor*(): Cursor =\n result = new Cursor\n result.init()\n\n\nmethod update*(entity: Cursor, elapsed: float) =\n entity.updateEntity(elapsed)\n entity.collidedWith = @[]\n entity.pos = mouse.abs\n\n\nmethod onCollide*(entity: Cursor, target: Entity) =\n if target.tags.len > 0:\n entity.collidedWith.add(target.tags[0])\n\n" }, { "path": "demos/demo5/demo5.nim", "content": "import\n sdl2_nim/sdl,\n nimgame2/nimgame,\n nimgame2/settings,\n mainscene\n\ngame = newGame()\nif game.init(w = 640, h = 480, title = \"Nimgame 2: Demo 5 (Collisions)\",\n scaleQuality = 0):\n showInfo = true\n colliderOutline = true\n discard sdl.showCursor(0)\n game.scene = newMainScene()\n game.run()\n\n" }, { "path": "demos/demo5/earth.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/entity\n\ntype\n Earth* = ref object of Entity\n collidedWith*: seq[string]\n\n\nproc init*(entity: Earth) =\n entity.initEntity()\n entity.tags.add(\"Earth\")\n entity.pos = (0.0, 150.0)\n entity.collidedWith = @[]\n\n\nproc newEarth*(): Earth =\n result = new Earth\n result.init()\n\n\nmethod update*(entity: Earth, elapsed: float) =\n entity.updateEntity(elapsed)\n entity.collidedWith = @[]\n\n\nmethod onCollide*(entity: Earth, target: Entity) =\n if target.tags.len > 0:\n entity.collidedWith.add(target.tags[0])\n\n" }, { "path": "demos/demo5/line.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/entity\n\ntype\n Line* = ref object of Entity\n collidedWith*: seq[string]\n\n\nproc init*(entity: Line) =\n entity.initEntity()\n entity.tags.add(\"Line\")\n entity.collidedWith = @[]\n\n\nproc newLine*(): Line =\n result = new Line\n result.init()\n\n\nmethod update*(entity: Line, elapsed: float) =\n entity.updateEntity(elapsed)\n entity.collidedWith = @[]\n\n\nmethod onCollide*(entity: Line, target: Entity) =\n if target.tags.len > 0:\n entity.collidedWith.add(target.tags[0])\n\n" }, { "path": "demos/demo5/mainscene.nim", "content": "import\n math,\n nimgame2/nimgame,\n nimgame2/draw,\n nimgame2/entity,\n nimgame2/texturegraphic,\n nimgame2/input,\n nimgame2/scene,\n nimgame2/settings,\n nimgame2/types,\n cursor, earth, line, poly1, poly2, poly3, poly9, spaceman\n\n\ntype\n MainScene = ref object of Scene\n cursorG, earthG, spacemanG: TextureGraphic\n c: Cursor\n e: Earth\n d1, d2: Line\n s: Spaceman\n p1: Poly1\n p2: Poly2\n p3: Poly3\n p9: Poly9\n\n\nproc init*(scene: MainScene) =\n Scene(scene).init()\n\n # Cursor\n scene.c = newCursor()\n scene.cursorG = newTextureGraphic()\n discard scene.cursorG.load(\"../assets/gfx/cursor.png\")\n scene.c.graphic = scene.cursorG\n scene.c.collider = newCollider(scene.c)\n\n # Line 1\n scene.d1 = newLine()\n scene.d1.pos = (50.0, 420.0)\n scene.d1.center = (25.0, 0.0)\n scene.d1.collider = scene.d1.newLineCollider((-25, 0), (25, 0))\n\n # Line 2\n scene.d2 = newLine()\n scene.d2.pos = (50.0, 450.0)\n scene.d2.collider = scene.d2.newLineCollider((0, 0), (100, 0))\n\n # Earth\n scene.e = newEarth()\n scene.earthG = newTextureGraphic()\n discard scene.earthG.load(\"../assets/gfx/earth.png\")\n scene.e.graphic = scene.earthG\n let radius = scene.earthG.dim.w.float / 2\n scene.e.collider = newCircleCollider(scene.e, (radius, radius), radius)\n\n # Spaceman\n scene.s = newSpaceman()\n scene.spacemanG = newTextureGraphic()\n discard scene.spacemanG.load(\"../assets/gfx/spaceman.png\")\n scene.s.graphic = scene.spacemanG\n scene.s.centrify()\n scene.s.collider = newBoxCollider(scene.s, (0, 0), scene.spacemanG.dim)\n\n # Poly1\n scene.p1 = newPoly1()\n scene.p1.pos = (350, 160)\n\n # Poly2\n scene.p2 = newPoly2()\n scene.p2.pos = (350, 210)\n\n # Poly3\n scene.p3 = newPoly3()\n scene.p3.pos = (350, 260)\n\n # Poly9\n scene.p9 = newPoly9()\n scene.p9.pos = (350, 360)\n\n # add to scene\n scene.add(scene.d1)\n scene.add(scene.d2)\n scene.add(scene.s)\n scene.add(scene.e)\n scene.add(scene.c)\n scene.add(scene.p1)\n scene.add(scene.p2)\n scene.add(scene.p3)\n scene.add(scene.p9)\n\n\nproc free*(scene: MainScene) =\n scene.earthG.free\n scene.spacemanG.free\n\n\nproc newMainScene*(): MainScene =\n new result, free\n result.init()\n\n\nmethod event*(scene: MainScene, event: Event) =\n if event.kind == KeyDown:\n case event.key.keysym.sym:\n of K_Escape:\n gameRunning = false\n of K_Space:\n colliderOutline = not colliderOutline\n else: discard\n\n\nproc generateCollisionString(name: string, list: seq[string]): string =\n if list.len > 0:\n result = name & \" collides with: \"\n for tag in list:\n result.add(tag & \", \")\n result = result[0 .. ^3]\n else:\n result = name & \" isn't colliding with anything\"\n\n\nmethod render*(scene: MainScene) =\n scene.renderScene()\n discard box((4, 60), (380, 140), 0x000000CC'u32)\n\n discard string(\n (8, 64), generateCollisionString(\"Cursor\", scene.c.collidedWith),\n 0xFFFFFFFF'u32)\n\n discard string(\n (8, 72), generateCollisionString(\"Line\", scene.d1.collidedWith),\n 0xFFFFFFFF'u32)\n\n discard string(\n (8, 80), generateCollisionString(\"Earth\", scene.e.collidedWith),\n 0xFFFFFFFF'u32)\n\n discard string(\n (8, 88), generateCollisionString(\"Spaceman\", scene.s.collidedWith),\n 0xFFFFFFFF'u32)\n\n discard string(\n (8, 96), generateCollisionString(\"Poly9\", scene.p9.collidedWith),\n 0xFFFFFFFF'u32)\n\n discard string(\n (8, 120), \"Space toggles outlines, Arrows control spaceman\",\n 0xFFFFFFFF'u32)\n\n discard string(\n (8, 128), \"WASDQE control line, IJKLUO control polygon\",\n 0xFFFFFFFF'u32)\n\n\nmethod update*(scene: MainScene, elapsed: float) =\n scene.updateScene(elapsed)\n # Spaceman\n if ScancodeRight.down: scene.s.pos.x += 1\n if ScancodeLeft.down: scene.s.pos.x -= 1\n if ScancodeDown.down: scene.s.pos.y += 1\n if ScancodeUp.down: scene.s.pos.y -= 1\n # Line\n if ScancodeD.down: scene.d1.pos.x += 1\n if ScancodeA.down: scene.d1.pos.x -= 1\n if ScancodeS.down: scene.d1.pos.y += 1\n if ScancodeW.down: scene.d1.pos.y -= 1\n if ScancodeQ.down: scene.d1.rot -= 1\n if ScancodeE.down: scene.d1.rot += 1\n # Poly9\n if ScancodeL.down: scene.p9.pos.x += 1\n if ScancodeJ.down: scene.p9.pos.x -= 1\n if ScancodeK.down: scene.p9.pos.y += 1\n if ScancodeI.down: scene.p9.pos.y -= 1\n if ScancodeU.down: scene.p9.rot -= 1\n if ScancodeO.down: scene.p9.rot += 1\n\n" }, { "path": "demos/demo5/poly1.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/entity\n\ntype\n Poly1* = ref object of Entity\n collidedWith*: seq[string]\n\n\nproc init*(entity: Poly1) =\n entity.initEntity()\n entity.tags.add(\"Poly1\")\n entity.collider = entity.newPolyCollider((0.0, 0.0),\n [ (0.0, 0.0)])\n entity.collidedWith = @[]\n\n\nproc newPoly1*(): Poly1 =\n result = new Poly1\n result.init()\n\n\nmethod update*(entity: Poly1, elapsed: float) =\n entity.updateEntity(elapsed)\n entity.collidedWith = @[]\n\n\nmethod onCollide*(entity: Poly1, target: Entity) =\n if target.tags.len > 0:\n entity.collidedWith.add(target.tags[0])\n\n" }, { "path": "demos/demo5/poly2.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/entity\n\ntype\n Poly2* = ref object of Entity\n collidedWith*: seq[string]\n\n\nproc init*(entity: Poly2) =\n entity.initEntity()\n entity.tags.add(\"Poly2\")\n entity.collider = entity.newPolyCollider((0.0, 0.0),\n [ (0.0, 0.0),\n (50.0, 0.0)])\n entity.collidedWith = @[]\n\n\nproc newPoly2*(): Poly2 =\n result = new Poly2\n result.init()\n\n\nmethod update*(entity: Poly2, elapsed: float) =\n entity.updateEntity(elapsed)\n entity.collidedWith = @[]\n\n\nmethod onCollide*(entity: Poly2, target: Entity) =\n if target.tags.len > 0:\n entity.collidedWith.add(target.tags[0])\n\n" }, { "path": "demos/demo5/poly3.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/entity\n\ntype\n Poly3* = ref object of Entity\n collidedWith*: seq[string]\n\n\nproc init*(entity: Poly3) =\n entity.initEntity()\n entity.tags.add(\"Poly3\")\n entity.collider = entity.newPolyCollider((0.0, 0.0),\n [ (0.0, 0.0),\n (50.0, 0.0),\n (25.0, 35.0)])\n entity.collidedWith = @[]\n\n\nproc newPoly3*(): Poly3 =\n result = new Poly3\n result.init()\n\n\nmethod update*(entity: Poly3, elapsed: float) =\n entity.updateEntity(elapsed)\n entity.collidedWith = @[]\n\n\nmethod onCollide*(entity: Poly3, target: Entity) =\n if target.tags.len > 0:\n entity.collidedWith.add(target.tags[0])\n\n" }, { "path": "demos/demo5/poly9.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/entity\n\ntype\n Poly9* = ref object of Entity\n collidedWith*: seq[string]\n\n\nproc init*(entity: Poly9) =\n entity.initEntity()\n entity.tags.add(\"Poly9\")\n entity.centrify\n entity.collider = entity.newPolyCollider((0.0, 0.0),\n [ (-40.0, -50.0),\n (-20.0, -50.0),\n (-30.0, 20.0),\n ( 30.0, 20.0),\n ( 20.0, -50.0),\n ( 40.0, -50.0),\n ( 40.0, 30.0),\n ( 0.0, 50.0),\n (-40.0, 30.0)])\n entity.collidedWith = @[]\n\n\nproc newPoly9*(): Poly9 =\n result = new Poly9\n result.init()\n\n\nmethod update*(entity: Poly9, elapsed: float) =\n entity.updateEntity(elapsed)\n entity.collidedWith = @[]\n\n\nmethod onCollide*(entity: Poly9, target: Entity) =\n if target.tags.len > 0:\n entity.collidedWith.add(target.tags[0])\n\n" }, { "path": "demos/demo5/spaceman.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/entity\n\ntype\n Spaceman* = ref object of Entity\n collidedWith*: seq[string]\n\n\nproc init*(entity: Spaceman) =\n entity.initEntity()\n entity.tags.add(\"Spaceman\")\n entity.pos = (450.0, 100.0)\n entity.collidedWith = @[]\n\n\nproc newSpaceman*(): Spaceman =\n result = new Spaceman\n result.init()\n\n\nmethod update*(entity: Spaceman, elapsed: float) =\n entity.updateEntity(elapsed)\n entity.collidedWith = @[]\n\n\nmethod onCollide*(entity: Spaceman, target: Entity) =\n if target.tags.len > 0:\n entity.collidedWith.add(target.tags[0])\n\n" }, { "path": "demos/demo6/README.md", "content": "Nimgame 2: Demo 6\n=================\n\nGrouping demo. Demonstrates effects of setting up entity parent.\n\n![Screenshot](demo6.png)\n\n" }, { "path": "demos/demo6/demo6.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/settings,\n mainscene\n\ngame = newGame()\nif game.init(w = 640, h = 480, title = \"Nimgame 2: Demo 6 (Grouping)\",\n scaleQuality = 0):\n showInfo = true\n game.scene = newMainScene()\n game.run()\n\n" }, { "path": "demos/demo6/earth.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/entity\n\ntype\n Earth* = ref object of Entity\n\n\nproc init*(entity: Earth) =\n entity.initEntity()\n entity.tags.add(\"Earth\")\n entity.pos = (320.0, 240.0)\n\n\nproc newEarth*(): Earth =\n result = new Earth\n result.init()\n\n" }, { "path": "demos/demo6/mainscene.nim", "content": "import\n math,\n nimgame2/nimgame,\n nimgame2/draw,\n nimgame2/entity,\n nimgame2/texturegraphic,\n nimgame2/input,\n nimgame2/scene,\n nimgame2/settings,\n nimgame2/types,\n earth, spaceman\n\n\ntype\n MainScene = ref object of Scene\n cursorG, earthG, spacemanG: TextureGraphic\n e: Earth\n s: Spaceman\n\n\nproc init*(scene: MainScene) =\n Scene(scene).init()\n\n # Earth\n scene.e = newEarth()\n scene.earthG = newTextureGraphic()\n discard scene.earthG.load(\"../assets/gfx/earth.png\")\n scene.e.graphic = scene.earthG\n scene.e.centrify()\n scene.e.collider = scene.e.newCircleCollider((0, 0), 128)\n\n # Spaceman\n scene.s = newSpaceman()\n scene.spacemanG = newTextureGraphic()\n discard scene.spacemanG.load(\"../assets/gfx/spaceman.png\")\n scene.s.graphic = scene.spacemanG\n scene.s.centrify()\n scene.s.parent = scene.e\n scene.s.collider = scene.s.newBoxCollider((0, 0), (100, 160))\n\n # add to scene\n scene.add(scene.s)\n scene.add(scene.e)\n\n\nproc free*(scene: MainScene) =\n scene.earthG.free\n scene.spacemanG.free\n\n\nproc newMainScene*(): MainScene =\n new result, free\n result.init()\n\n\nmethod event*(scene: MainScene, event: Event) =\n if event.kind == KeyDown:\n case event.key.keysym.sym:\n of K_Escape:\n gameRunning = false\n of K_Space:\n colliderOutline = not colliderOutline\n else: discard\n\n\nmethod render*(scene: MainScene) =\n scene.renderScene()\n discard box((4, 60), (260, 100), 0x000000CC'u32)\n\n discard string((8, 64), \"WASD - move group\", 0xFFFFFFFF'u32)\n discard string((8, 72), \"QE - rotate group\", 0xFFFFFFFF'u32)\n discard string((8, 80), \"RF - scale group\", 0xFFFFFFFF'u32)\n discard string((8, 88), \"Space - toggle outlines\", 0xFFFFFFFF'u32)\n\n\nmethod update*(scene: MainScene, elapsed: float) =\n scene.updateScene(elapsed)\n if ScancodeD.down: scene.e.pos.x += 1\n if ScancodeA.down: scene.e.pos.x -= 1\n if ScancodeS.down: scene.e.pos.y += 1\n if ScancodeW.down: scene.e.pos.y -= 1\n if ScancodeQ.down: scene.e.rot -= 1\n if ScancodeE.down: scene.e.rot += 1\n if ScancodeR.down: scene.e.scale -= 0.01\n if ScancodeF.down: scene.e.scale += 0.01\n\n" }, { "path": "demos/demo6/spaceman.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/entity\n\ntype\n Spaceman* = ref object of Entity\n\n\nproc init*(entity: Spaceman) =\n entity.initEntity()\n entity.tags.add(\"Spaceman\")\n entity.pos = (200.0, 0.0)\n\n\nproc newSpaceman*(): Spaceman =\n result = new Spaceman\n result.init()\n\n\nmethod update*(entity: Spaceman, elapsed: float) =\n entity.updateEntity(elapsed)\n\n" }, { "path": "demos/demo7/README.md", "content": "Nimgame 2: Demo 7\n=================\n\nText demo. Demonstrates bitmap and TrueType fonts.\n\n![Screenshot](demo7.png)\n\n" }, { "path": "demos/demo7/demo7.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/settings,\n mainscene\n\ngame = newGame()\nif game.init(w = 640, h = 480, title = \"Nimgame 2: Demo 6 (Text)\",\n scaleQuality = 0):\n showInfo = true\n game.scene = newMainScene()\n game.run()\n\n" }, { "path": "demos/demo7/earth.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/entity\n\ntype\n Earth* = ref object of Entity\n\n\nproc init*(entity: Earth) =\n entity.initEntity()\n entity.tags.add(\"Earth\")\n entity.pos = (0.0, 50.0)\n\n\nproc newEarth*(): Earth =\n result = new Earth\n result.init()\n\n" }, { "path": "demos/demo7/mainscene.nim", "content": "import\n math,\n nimgame2/nimgame,\n nimgame2/font,\n nimgame2/bitmapfont,\n nimgame2/truetypefont,\n nimgame2/draw,\n nimgame2/entity,\n nimgame2/graphic,\n nimgame2/textgraphic,\n nimgame2/texturegraphic,\n nimgame2/typewriter,\n nimgame2/input,\n nimgame2/scene,\n nimgame2/settings,\n nimgame2/types,\n earth\n\n\ntype\n MainScene = ref object of Scene\n earthG: TextureGraphic\n e: Earth\n bmFont: BitmapFont\n bmText: TextGraphic\n bmEntity: Entity\n ttFont: TrueTypeFont\n ttText: TextGraphic\n ttEntity: Entity\n twText: TextGraphic\n twEntity: Typewriter\n\n\nproc init*(scene: MainScene) =\n Scene(scene).init()\n\n # Earth\n scene.e = newEarth()\n scene.earthG = newTextureGraphic()\n discard scene.earthG.load(\"../assets/gfx/earth.png\")\n scene.e.graphic = scene.earthG\n\n # BitmapFont\n scene.bmFont = newBitmapFont()\n discard scene.bmFont.load(\"../assets/fnt/default8x16.png\", (8, 16))\n\n # TrueTypeFont\n scene.ttFont = newTrueTypeFont()\n discard scene.ttFont.load(\"../assets/fnt/FSEX300.ttf\", 16)\n\n # Text\n scene.bmText = newTextGraphic()\n scene.bmText.font = scene.bmFont\n scene.bmText.lines =\n [ \"The quick brown fox\",\n \"jumps over the lazy dog\"]\n\n scene.ttText = newTextGraphic()\n scene.ttText.font = scene.ttFont\n scene.ttText.lines =\n [ \"В чащах юга жил бы цитрус?\",\n \"Да, но фальшивый экземпляр!\"]\n\n scene.twText = newTextGraphic()\n scene.twText.font = scene.ttFont\n\n # Entity\n scene.bmEntity = newEntity()\n scene.bmEntity.pos = (8, 128)\n scene.bmEntity.graphic = scene.bmText\n\n scene.ttEntity = newEntity()\n scene.ttEntity.pos = (8, 192)\n scene.ttEntity.graphic = scene.ttText\n\n scene.twEntity = newTypewriter(scene.twText, 0.1)\n #scene.twEntity.width = 10 # uncomment to enable text wrapping\n scene.twEntity.pos = (300, 8)\n scene.twEntity.add \"Fancy typewriter effect!\"\n\n # add to scene\n scene.add(scene.bmEntity)\n scene.add(scene.ttEntity)\n scene.add(scene.twEntity)\n scene.add(scene.e)\n\n\nproc free*(scene: MainScene) =\n scene.bmFont.free()\n scene.ttFont.free()\n scene.bmText.free()\n scene.ttText.free()\n\n\nproc newMainScene*(): MainScene =\n new result, free\n result.init()\n\n\nproc changeAlign(scene: MainScene, increase = true) =\n # get\n var a = scene.bmText.align\n # change\n if increase:\n if a.int == 0:\n a = TextAlign(1)\n elif a < TextAlign.high:\n a = TextAlign(a.int shl 1)\n else: # decrease\n if a.int > 0:\n a = TextAlign(a.int shr 1)\n # set\n scene.bmText.align = a\n scene.ttText.align = a\n\nlet\n colors = [0xFFFFFFFF'u32, 0xFF0000FF'u32, 0x00FF00FF'u32, 0x0000FFFF'u32]\n colorNames = [\"white\", \"red\", \"green\", \"blue\"]\nvar clr = 0\n\nproc changeColor(scene: MainScene, increase = true) =\n # get alpha\n let a = scene.bmText.color.a\n # change\n if increase:\n if clr < colors.high:\n inc clr\n else: # decrease\n if clr > 0:\n dec clr\n # set\n var color: Color = colors[clr]\n color.a = a\n scene.bmText.color = color\n scene.ttText.color = color\n\n\nproc changeAlpha(scene: MainScene, increase = true) =\n # get\n var\n c = scene.bmText.color\n a = c.a.int\n # change\n if increase:\n a += 15\n else: # decrease\n a -= 15\n # check limits\n if a < 0:\n a = 0\n if a > 255:\n a = 255\n # set\n c.a = a.uint8\n scene.bmText.color = c\n scene.ttText.color = c\n\n\nmethod event*(scene: MainScene, event: Event) =\n if event.kind == KeyDown:\n case event.key.keysym.sym:\n of K_Escape:\n gameRunning = false\n of K_Q:\n scene.changeAlign()\n of K_A:\n scene.changeAlign(false)\n of K_W:\n scene.changeColor()\n of K_S:\n scene.changeColor(false)\n of K_E:\n scene.changeAlpha()\n of K_D:\n scene.changeAlpha(false)\n else: discard\n\n\nmethod render*(scene: MainScene) =\n scene.renderScene()\n\n discard box((4, 60), (260, 100), 0x000000CC'u32)\n\n discard string((8, 64), \"BitmapFont and TrueTypeFont:\", 0xFFFFFFFF'u32)\n discard string((8, 72),\n \"QA - change alignment: \" & $scene.bmText.align, 0xFFFFFFFF'u32)\n discard string((8, 80),\n \"WS - change color: \" & colorNames[clr], 0xFFFFFFFF'u32)\n discard string((8, 88),\n \"ED - change alpha: \" & $scene.bmText.color.a.int, 0xFFFFFFFF'u32)\n\n\nmethod update*(scene: MainScene, elapsed: float) =\n scene.updateScene(elapsed)\n\n if ScancodeReturn.down: scene.twEntity.force()\n\n" }, { "path": "demos/demo8/README.md", "content": "Nimgame 2: Demo 8\n=================\n\nProcGraphic demo. Demonstrates procedural graphics.\n\n![Screenshot](demo8.png)\n\n" }, { "path": "demos/demo8/demo8.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/settings,\n mainscene\n\ngame = newGame()\nif game.init(w = 640, h = 480, title = \"Nimgame 2: Demo 8 (ProcGraphic)\",\n scaleQuality = 0):\n showInfo = true\n game.scene = newMainScene()\n game.run()\n\n" }, { "path": "demos/demo8/mainscene.nim", "content": "import\n math,\n nimgame2/nimgame,\n nimgame2/draw,\n nimgame2/entity,\n nimgame2/graphic,\n nimgame2/input,\n nimgame2/procgraphic,\n nimgame2/scene,\n nimgame2/settings,\n nimgame2/types,\n nimgame2/utils\n\n\ntype\n MainScene = ref object of Scene\n polyG: ProcGraphic\n poly: Entity\n\n\nconst polyLines0 = [\n ( 0.0, -70.0),\n ( 40.0, -30.0),\n ( 80.0, -50.0),\n ( 60.0, 30.0),\n (-60.0, 30.0),\n (-80.0, -50.0),\n (-40.0, -30.0)]\n\nconst polyLines1 = [\n ((-30.0, 10.0), (-30.0, -10.0)),\n ((-30.0, -10.0), (-10.0, 10.0)),\n ((-10.0, 10.0), (-10.0, -10.0)),\n (( 0.0, -10.0), ( 0.0, 10.0)),\n (( 10.0, 10.0), ( 10.0, -10.0)),\n (( 10.0, -10.0), ( 20.0, 0.0)),\n (( 20.0, 0.0), ( 30.0, -10.0)),\n (( 30.0, -10.0), ( 30.0, 10.0))]\n\n\nproc polyProc(graphic: ProcGraphic,\n pos: Coord,\n angle: Angle,\n scale: Scale,\n center: Coord,\n flip: Flip,\n region: Rect) =\n let\n color0: Color = 0xFFFF00FF'u32\n color1: Color = 0x000000FF'u32\n\n var poly: seq[Coord] = @[]\n for p in polyLines0:\n poly.add(rotate(p, (0.0, 0.0), angle) * scale + pos)\n discard polygon(poly, color0, DrawMode.filled)\n\n for i in polyLines1:\n let\n p0 = rotate(i[0], (0.0, 0.0), angle) * scale + pos\n p1 = rotate(i[1], (0.0, 0.0), angle) * scale + pos\n discard aaLine(p0, p1, color1)\n\n\nproc init*(scene: MainScene) =\n Scene(scene).init()\n\n # Poly\n scene.poly = newEntity()\n scene.polyG = newProcGraphic()\n scene.polyG.procedure = polyProc\n scene.poly.graphic = scene.polyG\n scene.poly.pos = (320, 240)\n\n # add to scene\n scene.add(scene.poly)\n\n\nproc free*(scene: MainScene) =\n discard\n\n\nproc newMainScene*(): MainScene =\n new result, free\n result.init()\n\n\nmethod event*(scene: MainScene, event: Event) =\n if event.kind == KeyDown:\n case event.key.keysym.sym:\n of K_Escape:\n gameRunning = false\n else: discard\n\n\nmethod render*(scene: MainScene) =\n scene.renderScene()\n\n discard box((4, 60), (260, 92), 0x000000CC'u32)\n\n discard string((8, 64), \"WSAD - move\", 0xFFFFFFFF'u32)\n discard string((8, 72), \"QE - rotate\", 0xFFFFFFFF'u32)\n discard string((8, 80), \"RF - scale\", 0xFFFFFFFF'u32)\n\n\nmethod update*(scene: MainScene, elapsed: float) =\n scene.updateScene(elapsed)\n if ScancodeA.down: scene.poly.pos.x -= 1\n if ScancodeD.down: scene.poly.pos.x += 1\n if ScancodeW.down: scene.poly.pos.y -= 1\n if ScancodeS.down: scene.poly.pos.y += 1\n if ScancodeQ.down: scene.poly.rot -= 1\n if ScancodeE.down: scene.poly.rot += 1\n if ScancodeR.down: scene.poly.scale -= 0.01\n if ScancodeF.down: scene.poly.scale += 0.01\n\n" }, { "path": "demos/demo9/README.md", "content": "Nimgame 2: Demo 9\n=================\n\nAudio demo. Demonstrates sound effects.\n\n![Screenshot](demo9.png)\n\n" }, { "path": "demos/demo9/demo9.nim", "content": "import\n nimgame2/nimgame,\n nimgame2/settings,\n nimgame2/assets,\n nimgame2/texturegraphic,\n mainscene\n\ngame = newGame()\nif game.init(w = 640, h = 480, title = \"Nimgame 2: Demo 9 (Audio)\",\n scaleQuality = 0):\n showInfo = true\n game.scene = newMainScene()\n game.run()\n\n" }, { "path": "demos/demo9/mainscene.nim", "content": "import\n math,\n nimgame2/assets,\n nimgame2/audio,\n nimgame2/nimgame,\n nimgame2/draw,\n nimgame2/input,\n nimgame2/scene,\n nimgame2/settings,\n nimgame2/types,\n nimgame2/utils\n\n\ntype\n MainScene = ref object of Scene\n tack: Sound\n\n\nvar\n musicData: Assets[Music]\n\n\nproc init*(scene: MainScene) =\n Scene(scene).init()\n\n # Sound\n scene.tack = newSound(\"../assets/sfx/tack.wav\")\n scene.tack.volume = Volume.high div 2\n\n # Music\n musicData = newAssets[Music](\"../assets/mus\",\n proc(file: string): Music = newMusic(file))\n playlist = newPlaylist()\n for track in musicData.values:\n playlist.list.add(track)\n\n\nproc free*(scene: MainScene) =\n discard\n\n\nproc newMainScene*(): MainScene =\n new result, free\n result.init()\n\n\nmethod event*(scene: MainScene, event: Event) =\n if event.kind == KeyDown:\n case event.key.keysym.sym:\n of K_Escape:\n gameRunning = false\n of K_Space:\n discard scene.tack.play()\n of K_M:\n discard playlist.play()\n else: discard\n\n\nmethod render*(scene: MainScene) =\n scene.renderScene()\n\n discard box((4, 60), (260, 92), 0x000000CC'u32)\n\n discard string((8, 64), \"Space - play sound\", 0xFFFFFFFF'u32)\n discard string((8, 72),\n \"Up/Down - sound volume: \" & $scene.tack.volume, 0xFFFFFFFF'u32)\n discard string((8, 80), \"M - play random music track\", 0xFFFFFFFF'u32)\n discard string((8, 88),\n \"PgUp/PgDn - music volume: \" & $getMusicVolume(), 0xFFFFFFFF'u32)\n\n\nmethod update*(scene: MainScene, elapsed: float) =\n scene.updateScene(elapsed)\n if ScancodeUp.down: scene.tack.volumeInc(1)\n if ScancodeDown.down: scene.tack.volumeDec(1)\n if ScancodePageUp.down: musicVolumeInc(1)\n if ScancodePageDown.down: musicVolumeDec(1)\n\n" }, { "path": "demos/nim.cfg", "content": "--multimethods:on\n" }, { "path": "docs/changelog.html", "content": "\n\n\n \n\n Nimgame 2\n\n \n\n\n\n\n\n
\n
\n\n
\n \n\n\n
\n

CHANGELOG

\n\n

v0.5 alpha (2017-08-01)

\n
    \n
  • changed physics and logic systems
    • \n
  • platformer physics
    • \n
  • CoordInt type
    • \n
  • now collider module is autmatically included into the entity module
    • \n
  • group collider
    • \n
  • huge Tilemap optimizations
    • \n
  • various utility Tilemap procedures
    • \n
  • TextureGraphic.drawTiled
    • \n
  • GUI:\n
      \n
    • GUIProgressBar
      • \n
    • widget actions
      • \n
    \n
    • \n
  • various minor changes and upgrades
    • \n
  • Nim v0.17.0 transition
    • \n
  • documentation, snippets, and demos update
    • \n
  • \n \n second tutorial\n \n
\n\n

v0.4 alpha (2017-05-04)

\n
    \n
  • GUI:\n
      \n
    • RadioGroup
      • \n
    • RadioButton
      • \n
    \n
    • \n
  • IndexedImage
    • \n
  • PerspectiveImage
    • \n
  • TextureAtlas
    • \n
  • joysticks support
    • \n
  • window management procedures
    • \n
  • 4 new demos
    • \n
  • \n \n first tutorial\n \n
    • \n
\n\n

v0.3 alpha (2017-03-10)

\n\n
    \n
  • camera property (Scene)
    • \n
  • new collision procedures
    • \n
  • reworked input
    • \n
  • Mosaic
    • \n
  • parallax property (Entity)
    • \n
  • TextField
    • \n
  • GUI:\n
      \n
    • Widget
      • \n
    • Button
      • \n
    • TextInput
      • \n
    \n
    • \n
  • 3 new demos
    • \n
  • home page, snippets, and documentation
    • \n
\n\n

v0.2 alpha (2017-01-31)

\n\n
    \n
  • collider optimizations
    • \n
  • music playlists
    • \n
  • random procedures
    • \n
  • tilemaps
    • \n
  • tweens
    • \n
  • emitters
    • \n
  • various fixes
    • \n
  • 4 new demos
    • \n
\n\n

v0.1 alpha (2017-01-16)

\n\n
    \n
  • base scene/entity system
    • \n
  • assets manager
    • \n
  • basic sound and music
    • \n
  • colliders (point, box, circle, line, and polygon)
    • \n
  • fonts (bitmap and TrueType) and text output
    • \n
  • keyboard and mouse input
    • \n
  • vector drawing procedures
    • \n
\n\n
\n\n
\n\n\n\n\n\n\n\n\n" }, { "path": "docs/demos.html", "content": "\n\n\n \n\n Nimgame 2\n\n \n\n\n\n\n\n
\n
\n\n
\n \n\n
\n

DEMOS

\n\n

Game Demos

\n \n\n

Feature Demos

\n \n
\n
\n\n\n\n\n\n\n\n\n" }, { "path": "docs/docs/assets.html", "content": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\nassets\n\n\n\n\n\n\n\n\n
\n
\n

assets

\n
\n
\n
\n
    \n
\n
\n
\n Search: \n
\n
\n Group by:\n \n
\n \n\n
\n
\n
\n

\n
\n

Types

\n
\n\n
Assets[T] = OrderedTableRef[string, T]
\n
\n\n\n
\n\n
\n
\n

Procs

\n
\n\n
proc newAssets[T](files: openArray[string]; init: proc (file: string): T): Assets[T]
\n
\n

Create a new assets collection.

\n

files an array of target files.

\n

init T's init/load procedure.

\n\n\n
\n\n
proc newAssets[T](dir: string; init: proc (file: string): T): Assets[T]
\n
\n

Create a new assets collection.

\n

dir target directory.

\n

init T's init/load procedure.

\n\n\n
\n\n
\n\n
\n
\n\n
\n
\n \n
\n Made with Nim. Generated: 2019-01-21 14:58:31 UTC\n
\n
\n
\n
\n\n\n\n" }, { "path": "docs/docs/audio.html", "content": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\naudio\n\n\n\n\n\n\n\n\n
\n
\n

audio

\n
\n
\n
\n
    \n
\n
\n
\n Search: \n
\n
\n Group by:\n \n
\n \n\n
\n
\n
\n

\n \n
\n

Types

\n
\n\n
Channel = int
\n
\n\n\n
\n\n
Distance = range[0 .. 255]
\n
\n\n\n
\n\n
Panning = range[0 .. 255]
\n
\n\n\n
\n\n
Volume = range[0 .. mix.MaxVolume]
\n
\n\n\n
\n\n
Sound = ref object of RootObj\n  fChunk: mix.Chunk\n  fChannel: Channel\n
\n
\n\n\n
\n\n
Music = ref object of RootObj\n  fMusic: mix.Music\n
\n
\n\n\n
\n\n
Playlist = ref object of RootObj\n  list*: seq[Music]\n  fIndex: int\n  fFinished: bool\n
\n
\n\n\n
\n\n
\n
\n

Vars

\n
\n\n
playlist: Playlist = nil
\n
\n\n\n
\n\n
\n
\n

Procs

\n
\n\n
proc free(sound: Sound) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc load(sound: Sound; file: string): bool {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc load(sound: Sound; src: ptr RWops; freeSrc: bool = true): bool {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc newSound(file: string): Sound {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc newSound(src: ptr RWops; freeSrc: bool = true): Sound {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc available(sound: Sound): bool {...}{.raises: [], tags: [].}
\n
\nReturn true if the sound is ready to use, or false otherwise. \n\n
\n\n
proc playing(sound: Sound): bool {...}{.raises: [], tags: [].}
\n
\nReturn true if the sound is playing, or false otherwise. \n\n
\n\n
proc stop(sound: Sound) {...}{.raises: [], tags: [].}
\n
\nStop the sound. \n\n
\n\n
proc play(sound: Sound; loops: int = 0): Channel {...}{.raises: [], tags: [].}
\n
\n

Play the sound loops + 1 times.

\n

Return the channel the sound is played on.

\n\n\n
\n\n
proc channel(sound: Sound): Channel {...}{.raises: [], tags: [].}
\n
\nReturn the channel, the sound is played on. \n\n
\n\n
proc paused(sound: Sound): bool {...}{.raises: [], tags: [].}
\n
\nReturn true if the sound is paused, or false otherwise. \n\n
\n\n
proc pause(sound: Sound) {...}{.raises: [], tags: [].}
\n
\nPause the sound. \n\n
\n\n
proc resume(sound: Sound) {...}{.raises: [], tags: [].}
\n
\nResume the sound if it is paused. \n\n
\n\n
proc volume(sound: Sound): Volume {...}{.inline, raises: [], tags: [].}
\n
\nReturn the volume of the sound. \n\n
\n\n
proc normalizeVolume(val: int): Volume {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc volume=(sound: Sound; val: Volume) {...}{.inline, raises: [], tags: [].}
\n
\nSet sound volume. \n\n
\n\n
proc setDistance(channel: Channel; distance: Distance) {...}{.inline, raises: [], tags: [].}
\n
\nSet the distance on a channel.
distance:
\n
0 - near (loud) 255 - far (quiet)
\n
\n\n\n
\n\n
proc setPanning(channel: Channel; left: Panning = Panning.high;\n               right: Panning = Panning.high) {...}{.inline, raises: [], tags: [].}
\n
\n

Set the panning on a channel.

\n

Setting both left and right to 255 (Panning.high) will unregister the effect from channel.

\n\n\n
\n\n
proc setPosition(channel: Channel; angle: Angle; distance: Distance) {...}{.inline,\n    raises: [], tags: [].}
\n
\nSet the position on a channel.
angle:
\n
0 - front 90 - right 180 - behind 270 - left
\n
distance:
\n
0 - near (loud) 255 - far (quiet)
\n
\n\n\n
\n\n
proc soundStop() {...}{.inline, raises: [], tags: [].}
\n
\nStop all sound channels. \n\n
\n\n
proc soundPlayingNum(): int {...}{.inline, raises: [], tags: [].}
\n
\nReturn the number of currently playing channels. \n\n
\n\n
proc soundPausedNum(): int {...}{.inline, raises: [], tags: [].}
\n
\nReturn the number of currently paused channels. \n\n
\n\n
proc soundPause() {...}{.inline, raises: [], tags: [].}
\n
\nPause all sound channels. \n\n
\n\n
proc soundResume() {...}{.inline, raises: [], tags: [].}
\n
\nResume all sound channels. \n\n
\n\n
proc getSoundVolume(): Volume {...}{.inline, raises: [], tags: [].}
\n
\nReturn average sound volume. \n\n
\n\n
proc setSoundVolume(val: Volume) {...}{.inline, raises: [], tags: [].}
\n
\nSet new volume for all sound channels. \n\n
\n\n
proc free(music: Music) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc load(music: Music; file: string): bool {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc load(music: Music; src: ptr RWops; freeSrc: bool = true): bool {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc newMusic(file: string): Music {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc newMusic(src: ptr RWops; freeSrc: bool = true): Music {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc available(music: Music): bool {...}{.inline, raises: [], tags: [].}
\n
\nReturn true if the music is ready to use, or false otherwise. \n\n
\n\n
proc play(music: Music; loops: int = 0) {...}{.raises: [], tags: [].}
\n
\nPlay the music loops + 1 times. \n\n
\n\n
proc musicPaused(): bool {...}{.inline, raises: [], tags: [].}
\n
\nReturn true if music is paused, or false otherwise. \n\n
\n\n
proc musicPause() {...}{.inline, raises: [], tags: [].}
\n
\nPause music. \n\n
\n\n
proc musicResume() {...}{.inline, raises: [], tags: [].}
\n
\nResume music. \n\n
\n\n
proc musicRewind() {...}{.inline, raises: [], tags: [].}
\n
\nRewind music. \n\n
\n\n
proc musicPlaying(): bool {...}{.inline, raises: [], tags: [].}
\n
\nReturn true if music is playing, or false otherwise. \n\n
\n\n
proc musicStop() {...}{.inline, raises: [], tags: [].}
\n
\nStop music. \n\n
\n\n
proc musicPosition(val: float) {...}{.inline, raises: [], tags: [].}
\n
\n

Set current position in the music stream.

\n

Works only on MOD, OGG, and MP3 music:

\n

MOD val is a pattern number.

\n

OGG val is seconds from from the beginning.

\n

MP3 val is seconds from the current position.

\n\n\n
\n\n
proc init(pl: Playlist) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc newPlaylist(): Playlist {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc index(pl: Playlist): int {...}{.inline, raises: [], tags: [].}
\n
\nReturn current track index. \n\n
\n\n
proc play(pl: Playlist; index: int = -1): int {...}{.raises: [], tags: [].}
\n
\n

Play a music track from the playlist.

\n

index track index, or -1 for a random track.

\n

Retrun current track index.

\n\n\n
\n\n
proc stop(pl: Playlist) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc update(pl: Playlist) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
\n
\n

Templates

\n
\n\n
template volumeInc(sound: Sound; val: int)
\n
\nIncrease sound volume by val. \n\n
\n\n
template volumeDec(sound: Sound; val: int)
\n
\nDecrease sound volume by val. \n\n
\n\n
template playing(channel: Channel): bool
\n
\n\nReturn true if channel is playing right now, false otherwise. \n\n
\n\n
template soundVolumeInc(val: int)
\n
\nIncrease global sound volume by val. \n\n
\n\n
template soundVolumeDec(val: int)
\n
\nDecrease global sound volume by val. \n\n
\n\n
template setMusicVolume(val: Volume)
\n
\nSet music volume, or return current setting, if val = -1. \n\n
\n\n
template getMusicVolume(): Volume
\n
\n\n\n
\n\n
template musicVolumeInc(val: int)
\n
\nIncrease music volume by val. \n\n
\n\n
template musicVolumeDec(val: int)
\n
\nDecrease music volume by val. \n\n
\n\n
\n\n
\n
\n\n
\n
\n \n
\n Made with Nim. Generated: 2019-01-21 14:58:32 UTC\n
\n
\n
\n
\n\n\n\n" }, { "path": "docs/docs/bitmapfont.html", "content": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\nbitmapfont\n\n\n\n\n\n\n\n\n
\n
\n

bitmapfont

\n
\n
\n
\n
    \n
\n
\n
\n Search: \n
\n
\n Group by:\n \n
\n \n\n
\n
\n
\n

\n \n
\n

Types

\n
\n\n
BitmapFont = ref object of Font\n  fSurface: Surface            ## Source font surface\n  fDim, fCharDim: Dim           ## Dimensions of the surface and a single character\n  fChars: seq[CoordInt]        ## Coordinates of all characters\n
\n
\n\n\n
\n\n
\n
\n

Procs

\n
\n\n
proc free(font: BitmapFont) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc init(font: BitmapFont) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc load(font: BitmapFont; file: string; charDim: Dim; offset: Dim = (0, 0);\n         border: Dim = (0, 0)): bool {...}{.raises: [], tags: [].}
\n
\n

Load font data from a file.

\n

charDim dimensions of a single font character.

\n

offset offset from the edge of the texture.

\n

border border around individual characters.

\n

Return true on success, or false otherwise.

\n\n\n
\n\n
proc load(font: BitmapFont; src: ptr RWops; charDim: Dim; offset: Dim = (0, 0);\n         border: Dim = (0, 0); freeSrc: bool = true): bool {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc newBitmapFont(): BitmapFont {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc newBitmapFont(file: string; charDim: Dim; offset: Dim = (0, 0); border: Dim = (0, 0)): BitmapFont {...}{.\n    raises: [], tags: [].}
\n
\nCreate and load a new bitmap font from a file. \n\n
\n\n
proc newBitmapFont(src: ptr RWops; charDim: Dim; offset: Dim = (0, 0);\n                  border: Dim = (0, 0); freeSrc: bool = true): BitmapFont {...}{.raises: [],\n    tags: [].}
\n
\n\n\n
\n\n
proc renderBitmapFont(font: BitmapFont; line: string; color: Color = DefaultFontColor): Surface {...}{.\n    raises: [Exception], tags: [RootEffect].}
\n
\n\n\n
\n\n
\n
\n

Methods

\n
\n\n
method charH(font: BitmapFont): int {...}{.inline, raises: [], tags: [].}
\n
\nReturn a font character's height. \n\n
\n\n
method lineDim(font: BitmapFont; line: string): Dim {...}{.inline, raises: [], tags: [].}
\n
\nReturn dimensions of a line of text, written in font. \n\n
\n\n
method render(font: BitmapFont; line: string; color: Color = DefaultFontColor): Surface {...}{.\n    raises: [Exception], tags: [RootEffect].}
\n
\n\n\n
\n\n
\n\n
\n
\n\n
\n
\n \n
\n Made with Nim. Generated: 2019-01-21 14:58:32 UTC\n
\n
\n
\n
\n\n\n\n" }, { "path": "docs/docs/count.html", "content": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\nModule count\n\n\n\n\n\n\n\n\n
\n
\n

Module count

\n
\n
\n
\n Search: \n
\n
\n Group by:\n \n
\n \n\n
\n
\n
\n

\n \n
\n

Types

\n
\n
CountMgr* = ref object\n  counter: int\n  timerId: sdl.TimerID\n  current*: int\n
\n
\nCurrent counter value\n  Source\nEdit\n\n
\n\n
\n
\n

Procs

\n
\n
proc update*(mgr: CountMgr) {.
inline
.}
\n
\nIncrease the counter by one. \n  Source\nEdit\n\n
\n
proc start*(mgr: CountMgr; interval: uint32 = 1000)
\n
\n

Start the timer.

\n

interval Timer interval in ms.

\n\n  Source\nEdit\n\n
\n
proc stop*(mgr: CountMgr)
\n
\nStop the timer. \n  Source\nEdit\n\n
\n
proc free*(mgr: CountMgr)
\n
\n\n  Source\nEdit\n\n
\n
proc newCountMgr*(): CountMgr
\n
\n\n  Source\nEdit\n\n
\n
proc timeDiff*(first, second: uint64): int {.
inline
.}
\n
\n

first, second two results of sdl.getPerformanceCounter().

\n

Return time difference between two time stamps (in ms).

\n\n  Source\nEdit\n\n
\n\n
\n\n
\n
\n\n
\n
\n \n
\n Made with Nim. Generated: 2017-08-01 10:09:07 UTC\n
\n
\n
\n
\n\n\n\n" }, { "path": "docs/docs/draw.html", "content": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\ndraw\n\n\n\n\n\n\n\n\n
\n
\n

draw

\n
\n
\n
\n
    \n
\n
\n
\n Search: \n
\n
\n Group by:\n \n
\n \n\n
\n
\n
\n

\n \n
\n

Types

\n
\n\n
DrawMode {...}{.pure.} = enum\n  default, aa, filled
\n
\n\n\n
\n\n
\n
\n

Procs

\n
\n\n
proc pixel(pos: Coord; color: Color): bool {...}{.inline, raises: [], tags: [].}
\n
\nDraw a single pixel. \n\n
\n\n
proc hline(pos: Coord; length: float; color: Color): bool {...}{.inline, raises: [], tags: [].}
\n
\nDraw a horizontal line from pos to the right. \n\n
\n\n
proc vline(pos: Coord; height: float; color: Color): bool {...}{.inline, raises: [], tags: [].}
\n
\nDraw a vertical line from pos down. \n\n
\n\n
proc rect(pos1, pos2: Coord; color: Color): bool {...}{.inline, raises: [], tags: [].}
\n
\nDraw a rectangle. \n\n
\n\n
proc roundedRect(pos1, pos2: Coord; rad: float; color: Color): bool {...}{.inline, raises: [],\n    tags: [].}
\n
\nDraw a rounded rectangle. \n\n
\n\n
proc box(pos1, pos2: Coord; color: Color): bool {...}{.inline, raises: [], tags: [].}
\n
\nDraw a filled rectangle (box). \n\n
\n\n
proc roundedBox(pos1, pos2: Coord; rad: float; color: Color): bool {...}{.inline, raises: [],\n    tags: [].}
\n
\nDraw a rounded filled rectangle (box). \n\n
\n\n
proc line(pos1, pos2: Coord; color: Color): bool {...}{.inline, raises: [], tags: [].}
\n
\nDraw a line. \n\n
\n\n
proc aaLine(pos1, pos2: Coord; color: Color): bool {...}{.inline, raises: [], tags: [].}
\n
\nDraw an anti-aliased line. \n\n
\n\n
proc thickLine(pos1, pos2: Coord; width: float; color: Color): bool {...}{.inline, raises: [],\n    tags: [].}
\n
\nDraw a width pixels wide line. \n\n
\n\n
proc circle(pos: Coord; rad: float; color: Color; mode: DrawMode = DrawMode.default): bool {...}{.\n    raises: [], tags: [].}
\n
\nDraw a circle. \n\n
\n\n
proc arc(pos: Coord; rad, start, finish: Angle; color: Color): bool {...}{.inline, raises: [],\n    tags: [].}
\n
\nDraw an arc. \n\n
\n\n
proc ellipse(pos, rad: Coord; color: Color; mode: DrawMode = DrawMode.default): bool {...}{.\n    raises: [], tags: [].}
\n
\nDraw an ellipse. \n\n
\n\n
proc pie(pos: Coord; rad, start, finish: Angle; color: Color;\n        mode: DrawMode = DrawMode.default): bool {...}{.raises: [], tags: [].}
\n
\nDraw a circular sector (pie). \n\n
\n\n
proc trigon(pos1, pos2, pos3: Coord; color: Color; mode: DrawMode = DrawMode.default): bool {...}{.\n    raises: [], tags: [].}
\n
\nDraw a trigon. \n\n
\n\n
proc polygon(pos: openArray[Coord]; color: Color; mode: DrawMode = DrawMode.default;\n            surface: sdl.Surface = nil; surfaceD: Coord = (0, 0)): bool {...}{.\n    raises: [Exception], tags: [].}
\n
\nDraw a polygon. \n\n
\n\n
proc bezier(pos: openArray[Coord]; s: float; color: Color): bool {...}{.raises: [Exception],\n    tags: [].}
\n
\nDraw a bezier curve. \n\n
\n\n
proc setFont(fontdata: pointer; dim: Dim) {...}{.raises: [], tags: [].}
\n
\nSet sdl_gfx_primitives font. \n\n
\n\n
proc character(pos: Coord; c: char; color: Color): bool {...}{.inline, raises: [], tags: [].}
\n
\nDraw a single character. \n\n
\n\n
proc string(pos: Coord; s: string; color: Color): bool {...}{.inline, raises: [], tags: [].}
\n
\nDraw a string of text. \n\n
\n\n
\n
\n

Templates

\n
\n\n
template setFont()
\n
\nSet default sdl_gfx_primitives font. \n\n
\n\n
template setFontRotation(rotation: uint32)
\n
\nSet sdl_gfx_primitives font rotation. \n\n
\n\n
\n\n
\n
\n\n
\n
\n \n
\n Made with Nim. Generated: 2019-01-21 14:58:33 UTC\n
\n
\n
\n
\n\n\n\n" }, { "path": "docs/docs/emitter.html", "content": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\nemitter\n\n\n\n\n\n\n\n\n
\n
\n

emitter

\n
\n
\n
\n
    \n
\n
\n
\n Search: \n
\n
\n Group by:\n \n
\n \n\n
\n
\n
\n \n

\n \n
\n

Types

\n
\n\n
Particle = ref object of Entity\n  ttl*: float                  ## Time to live (in seconds)\n
\n
\n\n\n\n
\n\n
EmissionAreaKind = enum\n  eaPoint, eaLine, eaCircle, eaBox
\n
\n\n\n\n
\n\n
EmissionArea = object\n  case kind*: EmissionAreaKind\n  of eaPoint:\n    nil\n  of eaLine:\n    length*: float             ## line length\n  of eaCircle:\n    radius*: float             ## circle radius\n  of eaBox:\n    dim*: Dim                  ## box dimensions\n
\n
\n\n\n\n
\n\n
Emitter = ref object of Entity\n  randomVel*, randomAcc*: Coord ## Ranges of vel and acc deviation\n  randomRot*, randomRotVel*: Angle ## Ranges of rot and rotVel deviation\n  randomScale*: Scale          ## Range of scale deviation\n  randomTTL*: float            ## Range of TTL deviation\n  scene*: Scene                ## Target scene\n  area*: EmissionArea          ## Area of particle emission\n  particle*: Particle          ## A stencil particle, its properties will be \\\\\n                    ## assigned to any created particles.\n
\n
\n\n\n\n
\n\n
\n
\n

Procs

\n
\n\n
proc initParticle(particle: Particle) {...}{.raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc newParticle(): Particle {...}{.raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc updateParticle(particle: Particle; elapsed: float) {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n\n
\n\n
proc initEmitter(emitter: Emitter; scene: Scene; area = eaPoint) {...}{.raises: [], tags: [].}
\n
\n\nCreate a new Emitter for the scene. \n\n
\n\n
proc newEmitter(scene: Scene; area = eaPoint): Emitter {...}{.raises: [], tags: [].}
\n
\n\nCreate a new Emitter in the scene. \n\n
\n\n
proc emit(emitter: Emitter; amount: int = 1; procedure: proc (p: Particle) = nil) {...}{.\n    raises: [], tags: [].}
\n
\n\nEmit an amount of particles, apply the procedure for each emitted particle. \n\n
\n\n
\n
\n

Methods

\n
\n\n
method update(particle: Particle; elapsed: float) {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n\n
\n\n
\n
\n

Templates

\n
\n\n
template copy(target, source: Particle)
\n
\n\nCopy source properties to the target. \n\n
\n\n
\n\n
\n
\n\n
\n
\n \n
\n Made with Nim. Generated: 2019-06-15 20:16:23 UTC\n
\n
\n
\n
\n\n\n\n" }, { "path": "docs/docs/entity.html", "content": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\nentity\n\n\n\n\n\n\n\n\n
\n
\n

entity

\n
\n
\n
\n
    \n
\n
\n
\n Search: \n
\n
\n Group by:\n \n
\n \n\n
\n
\n
\n

Do not import this file. It is included in entity.nim automatically.

\n \n
\n

Types

\n
\n\n
Animation = object\n  frames*: seq[int]            ## List of animation's frame indexes\n  frameRate*: float            ## Frame rate (in seconds per frame)\n  flip*: Flip                  ## Flip flag\n
\n
\n\n\n
\n\n
AnimationCallback = proc (entity: Entity; index: int)
\n
\n

\nCalled after animation is finished (see play() procedure).

\n

index The index of the finished animation.

\n\n\n
\n\n
Sprite = ref object\n  animationKeys*: seq[string]  ## List of animation names\n  animations*: seq[Animation]  ## List of animations\n  currentAnimationIndex*: int  ## Index of currently playing animation\n  currentFrame*: int           ## Index of current frame in currentAnimation \\\n                   ## (or in ``frames``, if no currentAnimation is set)\n  cycles*: int                 ## Animation cycles counter (`-1` for looping)\n  kill*: bool                  ## Kill when animation is finished\n  callback*: AnimationCallback ## Call this when animation is finished\n  time*: float                 ## Animation timer\n  playing*: bool               ## Animation playing flag\n  dim*: Dim                    ## Sprite frame dimensions\n  frames*: seq[Rect]           ## Frames' coordinates\n
\n
\n\n\n
\n\n
Collider = ref object of RootObj\n  parent*: Entity\n  tags*: seq[string]           ## only check collisios with entities with given tags\n  pos*: Coord\n
\n
\n\n\n
\n\n
BoxCollider = ref object of Collider\n  dim*: Dim\n
\n
\n\n\n
\n\n
CircleCollider = ref object of Collider\n  radius*: float\n
\n
\n\n\n
\n\n
LineCollider = ref object of Collider\n  pos2*: Coord\n
\n
\n\n\n
\n\n
PolyCollider = ref object of Collider\n  farthest: float\n  points*: seq[Coord]\n
\n
\n\n\n
\n\n
GroupCollider = ref object of Collider\n  list*: seq[Collider]\n
\n
\n\n\n
\n\n
Entity = ref object of RootObj\n  fLayer: int                  ## Rendering layer\n  fBlinkTimer: float           ## Used internally for blinking\n  parent*: Entity              ## Parent entity reference\n  tags*: seq[string]           ## List of entity tags\n  dead*: bool                  ## `true` if marked for removal\n  updLayer*: bool              ## `true` if entity's layer was changed\n  graphic*: Graphic\n  sprite*: Sprite\n  logic*: LogicProc\n  physics*: PhysicsProc\n  fastPhysics*: bool           ## rough and fast physics flag\n  collisionEnvironment*: seq[Entity] ## List of collidable entites\n                                   ## used in some physics procedures\n  collider*: Collider\n  colliding*: seq[Entity]      ## List of Entities currently colliding with\n  pos*, vel*, acc*, drg*: Coord   ## Position, velocity, acceleration, drag\n  rot*: Angle                  ## Rotation angle in degrees\n  rotVel*, rotAcc*, rotDrg*: Angle ## Rotation velocity, acceleration, drag\n  parallax*, scale*: Scale      ## Parallax and scale ratio\n  scaleVel*, scaleAcc*, scaleDrg*: Scale ## Scale's velocity, accel., and drag\n  center*: Coord               ## Center for drawing and rotating\n  flip*: Flip                  ## Texture flip status\n  visible*: bool               ## Visibility status\n  blinking*: bool              ## Blinking status\n  blinkOn*, blinkOff*: float    ## Blinking rate (in seconds)\n
\n
\n\n\n
\n\n
LogicProc = proc (entity: Entity; elapsed: float)
\n
\n\n\n
\n\n
PhysicsProc = proc (entity: Entity; elapsed: float)
\n
\n\n\n
\n\n
\n
\n

Procs

\n
\n\n
proc initSprite(entity: Entity; dim: Dim; offset: Dim = (0, 0); border: Dim = (0, 0)) {...}{.\n    raises: [Exception], tags: [RootEffect].}
\n
\n

Creeate a sprite for the given entity with the attached Graphic.

\n

dim dimensions of one frame.

\n

offset offset from the edge of the texture.

\n

border border around individual frames.

\n\n\n
\n\n
proc animationIndex(sprite: Sprite; name: string): int {...}{.inline, raises: [], tags: [].}
\n
\nReturn the index of the animation named name. \n\n
\n\n
proc animation(sprite: Sprite; name: string): var Animation {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc animation(sprite: Sprite; index: int): var Animation {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc currentAnimation(sprite: Sprite): var Animation {...}{.raises: [], tags: [].}
\n
\nReturn the current animation. \n\n
\n\n
proc currentAnimationName(sprite: Sprite): string {...}{.raises: [], tags: [].}
\n
\nReturn the name of the current animation, or empty string if none. \n\n
\n\n
proc changeFramerate(sprite: Sprite; frameRate: float = 0.1) {...}{.raises: [], tags: [].}
\n
\nChange framerate for all created animations. \n\n
\n\n
proc addAnimation(sprite: Sprite; name: string; frames: openArray[int];\n                 frameRate: float = 0.1; flip: Flip = Flip.none): bool {...}{.raises: [],\n    tags: [].}
\n
\n

Add a new animation to the sprite.

\n

name name of the animation.

\n

frames array of animation frames' indexes.

\n

frameRate animation speed in seconds per frame.

\n

flip animation flip flag.

\n\n\n
\n\n
proc play(sprite: Sprite; anim: string; cycles = -1; kill: bool = false;\n         callback: AnimationCallback = nil) {...}{.raises: [], tags: [].}
\n
\n

Start playing the animation.

\n

anim name of the animation.

\n

cycles number of times to repeat the animation, or -1 for looping.

\n

kill kill when finished.

\n

callback called when animation is finished.

\n\n\n
\n\n
proc defaultPhysics(entity: Entity; elapsed: float) {...}{.raises: [], tags: [].}
\n
\n

Default physics procedure. Disabled by default.

\n

Assign it as your entity's physics.

\n\n\n
\n\n
proc platformerPhysics(entity: Entity; elapsed: float) {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n

Platformer physics procedure.

\n

Assign it as your entity's physics.

\n\n\n
\n\n
proc initEntity(entity: Entity) {...}{.raises: [], tags: [].}
\n
\n

Default entity initialization procedure.

\n

Call it after creating a new entity.

\n\n\n
\n\n
proc newEntity(): Entity {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc layer(entity: Entity): int {...}{.inline, raises: [], tags: [].}
\n
\nReturn current rendering layer of the entity. \n\n
\n\n
proc layer=(entity: Entity; val: int) {...}{.raises: [], tags: [].}
\n
\nChange the rendering layer of the entity. \n\n
\n\n
proc copy(target, source: Entity) {...}{.raises: [], tags: [].}
\n
\n

Copy source's properties to the other entity.

\n

No new objects will be allocated.

\n\n\n
\n\n
proc absRot(entity: Entity): Angle {...}{.raises: [], tags: [].}
\n
\nReturn the absolute (counting the parent's) rotation angle of the entity. \n\n
\n\n
proc absScale(entity: Entity): Scale {...}{.raises: [], tags: [].}
\n
\nReturn the absolute (counting the parent's) scale of the entity. \n\n
\n\n
proc absPos(entity: Entity): Coord {...}{.raises: [], tags: [].}
\n
\nReturn the absolute (counting the parent's) scale of the entity. \n\n
\n\n
proc centrify(entity: Entity; hor = HAlign.center; ver = VAlign.center) {...}{.\n    raises: [Exception], tags: [RootEffect].}
\n
\n

Set entity's center, according to the given align.

\n

hor Horisontal align: left, center, or right

\n

ver Vertical align: top, center, or bottom

\n\n\n
\n\n
proc renderEntity(entity: Entity) {...}{.raises: [Exception], tags: [RootEffect].}
\n
\n

Default entity render procedure.

\n

Call it from your entity render method.

\n\n\n
\n\n
proc updateEntity(entity: Entity; elapsed: float) {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n

Default entity update procedure.

\n

Call it from your entity update method.

\n\n\n
\n\n
proc init(a: Collider; parent: Entity; pos: Coord = (0, 0)) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc newCollider(parent: Entity; pos: Coord = (0, 0)): Collider {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc renderCollider(a: Collider) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc init(b: BoxCollider; parent: Entity; pos: Coord = (0, 0); dim: Dim = (0, 0)) {...}{.raises: [],\n    tags: [].}
\n
\n\n\n
\n\n
proc newBoxCollider(parent: Entity; pos: Coord = (0, 0); dim: Dim = (0, 0)): BoxCollider {...}{.\n    raises: [], tags: [].}
\n
\n\n\n
\n\n
proc init(c: CircleCollider; parent: Entity; pos: Coord = (0, 0); radius: float = 0) {...}{.\n    raises: [], tags: [].}
\n
\n\n\n
\n\n
proc newCircleCollider(parent: Entity; pos: Coord = (0, 0); radius: float = 0): CircleCollider {...}{.\n    raises: [], tags: [].}
\n
\n\n\n
\n\n
proc init(d: LineCollider; parent: Entity; pos: Coord = (0, 0); pos2: Coord = (0, 0)) {...}{.\n    raises: [], tags: [].}
\n
\n\n\n
\n\n
proc newLineCollider(parent: Entity; pos: Coord = (0, 0); pos2: Coord = (0, 0)): LineCollider {...}{.\n    raises: [], tags: [].}
\n
\n\n\n
\n\n
proc init(p: PolyCollider; parent: Entity; pos: Coord = (0, 0); points: openArray[Coord]) {...}{.\n    raises: [], tags: [].}
\n
\n\n\n
\n\n
proc updateFarthest(p: PolyCollider) {...}{.inline, raises: [], tags: [].}
\n
\nCall this procedure any time you changed points' coordinates. \n\n
\n\n
proc newPolyCollider(parent: Entity; pos: Coord = (0, 0); points: openArray[Coord]): PolyCollider {...}{.\n    raises: [], tags: [].}
\n
\n\n\n
\n\n
proc init(g: GroupCollider; parent: Entity) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc newGroupCollider(parent: Entity): GroupCollider {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc checkCollisions(entity: Entity; list: seq[Entity]) {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\nTrigger onCollide method of entity with a given list of targets. \n\n
\n\n
proc isColliding(entity: Entity; list: seq[Entity]): bool {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\nReturn true if entity collides with one of the elements in the given list, or false if no collisions occurs. \n\n
\n\n
proc willCollide(entity: Entity; pos: Coord; rot: Angle; scale: Scale; list: seq[Entity]): bool {...}{.\n    raises: [Exception], tags: [RootEffect].}
\n
\nReturn true if entity will collide with one of the elements in the given list, if entity's coordinates or dimentsions will change. \n\n
\n\n
\n
\n

Methods

\n
\n\n
method event(entity: Entity; e: sdl.Event) {...}{.base, raises: [], tags: [].}
\n
\n\n\n
\n\n
method render(entity: Entity) {...}{.base, raises: [Exception], tags: [RootEffect].}
\n
\n\n\n
\n\n
method update(entity: Entity; elapsed: float) {...}{.base, raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method onCollide(entity, target: Entity) {...}{.base, raises: [], tags: [].}
\n
\nCalled when entity collides with target. \n\n
\n\n
method collide(pos: Coord; a: Collider): bool {...}{.base, inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(pos: Coord; b: BoxCollider): bool {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(pos: Coord; c: CircleCollider): bool {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(pos: Coord; d: LineCollider): bool {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(pos: Coord; p: PolyCollider): bool {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method render(a: Collider) {...}{.base, raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(a: Collider; pos: Coord): bool {...}{.base, inline, raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(a1, a2: Collider): bool {...}{.base, inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(a: Collider; b: BoxCollider): bool {...}{.inline, raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(a: Collider; c: CircleCollider): bool {...}{.inline, raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(a: Collider; d: LineCollider): bool {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(a: Collider; p: PolyCollider): bool {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(a: Collider; g: GroupCollider): bool {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method render(b: BoxCollider) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(b: BoxCollider; pos: Coord): bool {...}{.inline, raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(b: BoxCollider; a: Collider): bool {...}{.inline, raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(b1, b2: BoxCollider): bool {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(b: BoxCollider; c: CircleCollider): bool {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(b: BoxCollider; d: LineCollider): bool {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(b: BoxCollider; p: PolyCollider): bool {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(b: BoxCollider; g: GroupCollider): bool {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method render(c: CircleCollider) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(c: CircleCollider; pos: Coord): bool {...}{.inline, raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(c: CircleCollider; a: Collider): bool {...}{.inline, raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(c: CircleCollider; b: BoxCollider): bool {...}{.inline, raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(c1, c2: CircleCollider): bool {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(c: CircleCollider; d: LineCollider): bool {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(c: CircleCollider; p: PolyCollider): bool {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(c: CircleCollider; g: GroupCollider): bool {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method render(d: LineCollider) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(d: LineCollider; pos: Coord): bool {...}{.inline, raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(d: LineCollider; a: Collider): bool {...}{.inline, raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(d: LineCollider; b: BoxCollider): bool {...}{.inline, raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(d: LineCollider; c: CircleCollider): bool {...}{.inline, raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(d1, d2: LineCollider): bool {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(d: LineCollider; p: PolyCollider): bool {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(d: LineCollider; g: GroupCollider): bool {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method render(p: PolyCollider) {...}{.raises: [Exception], tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(p: PolyCollider; pos: Coord): bool {...}{.inline, raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(p: PolyCollider; a: Collider): bool {...}{.inline, raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(p: PolyCollider; b: BoxCollider): bool {...}{.inline, raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(p: PolyCollider; c: CircleCollider): bool {...}{.inline, raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(p: PolyCollider; d: LineCollider): bool {...}{.inline, raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(p1, p2: PolyCollider): bool {...}{.raises: [Exception], tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(p: LineCollider; g: GroupCollider): bool {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method render(g: GroupCollider) {...}{.raises: [Exception], tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(g: GroupCollider; pos: Coord): bool {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(g: GroupCollider; a: Collider): bool {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(g: GroupCollider; b: BoxCollider): bool {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(g: GroupCollider; c: CircleCollider): bool {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(g: GroupCollider; d: LineCollider): bool {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(g: GroupCollider; p: PolyCollider): bool {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
\n
\n

Templates

\n
\n\n
template animationIndex(entity: Entity; name: string): int
\n
\nReturn the index of the animation named name. \n\n
\n\n
template animation(entity: Entity; name: string): var Animation
\n
\nReturn the animation named name. \n\n
\n\n
template animation(entity: Entity; index: int): var Animation
\n
\nReturn the animation under given index. \n\n
\n\n
template currentAnimationIndex(entity: Entity): int
\n
\n\n\n
\n\n
template currentAnimation(entity: Entity): var Animation
\n
\nReturn the current animation. \n\n
\n\n
template currentAnimationName(entity: Entity): string
\n
\nReturn the name of the current animation or empty string if none. \n\n
\n\n
template changeFramerate(entity: Entity; frameRate: float = 0.1)
\n
\nChange framerate for all created animations. \n\n
\n\n
template addAnimation(entity: Entity; name: string; frames: openArray[int];\n                     frameRate: float = 0.1; flip: Flip = Flip.none): bool
\n
\n

Add a new animation to the entity.

\n

name name of the animation.

\n

frames array of animation frames' indexes.

\n

frameRate animation speed in seconds per frame.

\n

flip animation flip flag.

\n\n\n
\n\n
template play(entity: Entity; anim: string; cycles = -1; kill: bool = false;\n             callback: AnimationCallback = nil)
\n
\n

Start playing the animation.

\n

anim name of the animation.

\n

cycles number of times to repeat the animation, or -1 for looping.

\n

kill kill when finished.

\n

callback called when animation is finished.

\n\n\n
\n\n
template dim(entity: Entity): Dim
\n
\nReturn entity.sprite.dim if entity.sprite is not nil, or entity.graphic.dim otherwise.\n\n
\n\n
template transform(entity: Entity): Transform
\n
\n\n\n
\n\n
template transform=(entity: Entity; transform: Transform)
\n
\n\n\n
\n\n
template rect(entity: Entity): Rect
\n
\n\n\n
\n\n
template topleft(entity: Entity): Coord
\n
\n\n\n
\n\n
template topright(entity: Entity): Coord
\n
\n\n\n
\n\n
template bottomright(entity: Entity): Coord
\n
\n\n\n
\n\n
template bottomleft(entity: Entity): Coord
\n
\n\n\n
\n\n
template corners(entity: Entity): untyped
\n
\n\n\n
\n\n
template worldCorners(entity: Entity): untyped
\n
\n\n\n
\n\n
template collide(pos1, pos2: Coord): bool
\n
\n\n\n
\n\n
\n\n
\n
\n\n
\n
\n \n
\n Made with Nim. Generated: 2019-01-21 14:58:34 UTC\n
\n
\n
\n
\n\n\n\n" }, { "path": "docs/docs/font.html", "content": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\nfont\n\n\n\n\n\n\n\n\n
\n
\n

font

\n
\n
\n
\n
    \n
\n
\n
\n Search: \n
\n
\n Group by:\n \n
\n \n\n
\n
\n
\n

\n \n
\n

Types

\n
\n\n
Font = ref object of RootObj
\n
\n\n\n
\n\n
\n
\n

Consts

\n
\n\n
DefaultFontColor: Color = 0xFFFFFFFF'u32
\n
\n\n\n
\n\n
\n
\n

Procs

\n
\n\n
proc renderLineFont(font: Font; line: string; color: Color = DefaultFontColor): Texture {...}{.\n    raises: [Exception], tags: [RootEffect].}
\n
\nRender a text line in font with given color. \n\n
\n\n
proc renderTextFont(font: Font; text: openArray[string]; align = TextAlign.left;\n                   color: Color = DefaultfontColor): Texture {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\nRender a multi-line text in font with given align and color. \n\n
\n\n
\n
\n

Methods

\n
\n\n
method charH(font: Font): int {...}{.base, raises: [], tags: [].}
\n
\n\n\n
\n\n
method lineDim(font: Font; text: string): Dim {...}{.base, raises: [], tags: [].}
\n
\n\n\n
\n\n
method render(font: Font; line: string; color: Color = DefaultFontColor): Surface {...}{.base,\n    raises: [], tags: [].}
\n
\n\n\n
\n\n
method renderLine(font: Font; line: string; color: Color = DefaultFontColor): Texture {...}{.\n    base, raises: [Exception], tags: [RootEffect].}
\n
\nBase renderLine() font method. \n\n
\n\n
method renderText(font: Font; text: openArray[string]; align = TextAlign.left;\n                 color: Color = DefaultfontColor): Texture {...}{.base,\n    raises: [Exception], tags: [RootEffect].}
\n
\nBase renderText() font method. \n\n
\n\n
\n\n
\n
\n\n
\n
\n \n
\n Made with Nim. Generated: 2019-01-21 14:58:34 UTC\n
\n
\n
\n
\n\n\n\n" }, { "path": "docs/docs/graphic.html", "content": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\ngraphic\n\n\n\n\n\n\n\n\n
\n
\n

graphic

\n
\n
\n
\n
    \n
\n
\n
\n Search: \n
\n
\n Group by:\n \n
\n \n\n
\n
\n
\n

\n
\n

Imports

\n
\ntypes\n
\n
\n

Types

\n
\n\n
Graphic = ref object of RootObj
\n
\n\n\n
\n\n
\n
\n

Methods

\n
\n\n
method w(graphic: Graphic): int {...}{.base, raises: [], tags: [].}
\n
\n\n\n
\n\n
method h(graphic: Graphic): int {...}{.base, raises: [], tags: [].}
\n
\n\n\n
\n\n
method dim(graphic: Graphic): Dim {...}{.base, raises: [], tags: [].}
\n
\n\n\n
\n\n
method draw(graphic: Graphic; pos: Coord = (0.0, 0.0); angle: Angle = 0.0;\n           scale: Scale = 1.0; center: Coord = (0.0, 0.0); flip: Flip = Flip.none;\n           region: Rect = Rect(x: 0, y: 0, w: 0, h: 0)) {...}{.base, raises: [], tags: [].}
\n
\n\n\n
\n\n
\n
\n

Templates

\n
\n\n
template rect(self: Graphic; offset: Coord): Rect
\n
\n\n\n
\n\n
\n\n
\n
\n\n
\n
\n \n
\n Made with Nim. Generated: 2019-01-21 14:58:35 UTC\n
\n
\n
\n
\n\n\n\n" }, { "path": "docs/docs/gui/button.html", "content": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\nbutton\n\n\n\n\n\n\n\n\n
\n
\n

button

\n
\n
\n
\n
    \n
\n
\n
\n Search: \n
\n
\n Group by:\n \n
\n \n\n
\n
\n
\n

\n \n
\n

Types

\n
\n\n
GuiButton = ref object of GuiWidget\n  image*: Graphic              ## The graphic to render on top of a button\n  imageOffset*: Coord          ## Image drawing offset from button's center. \\\n                    ## Calcuclated automatically if the image is passed in ``init()``\n  imageShift*: Coord           ## Image shift when button is pressed\n
\n
\n\n\n
\n\n
\n
\n

Procs

\n
\n\n
proc init(button: GuiButton; graphic: Graphic; image: Graphic = nil; circle: bool = false) {...}{.\n    raises: [Exception], tags: [RootEffect].}
\n
\n

GuiButton initialization.

\n

graphic 2x3 button graphic: defaultUp, defaultDown, focusedUp, focusedDown, disabledUp, disabledDown.

\n

image The graphic to render on top of a butotn.

\n

circle Set to true if you want a circle shape instead of square one.

\n\n\n
\n\n
proc newGuiButton(graphic: Graphic; image: Graphic = nil; circle: bool = false): GuiButton {...}{.\n    raises: [Exception], tags: [RootEffect].}
\n
\n

Create a new GuiButton.

\n

graphic 2x3 button graphic: defaultUp, defaultDown, focusedUp, focusedDown, disabledUp, disabledDown.

\n

image The graphic to render on top of a butotn.

\n

circle Set to true if you want a circle shape instead of square one.

\n\n\n
\n\n
proc renderGuiButton(button: GuiButton) {...}{.raises: [Exception], tags: [RootEffect].}
\n
\n

Default button render procedure.

\n

Call it from your button render method.

\n\n\n
\n\n
\n
\n

Methods

\n
\n\n
method state=(button: GuiButton; val: GuiState) {...}{.raises: [], tags: [].}
\n
\nReturn button's state. \n\n
\n\n
method render(button: GuiButton) {...}{.raises: [Exception], tags: [RootEffect].}
\n
\n\n\n
\n\n
\n\n
\n
\n\n
\n
\n \n
\n Made with Nim. Generated: 2019-01-21 14:59:38 UTC\n
\n
\n
\n
\n\n\n\n" }, { "path": "docs/docs/gui/progressbar.html", "content": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\nprogressbar\n\n\n\n\n\n\n\n\n
\n
\n

progressbar

\n
\n
\n
\n
    \n
\n
\n
\n Search: \n
\n
\n Group by:\n \n
\n \n\n
\n
\n
\n

\n \n
\n

Types

\n
\n\n
GuiProgressBar = ref object of GuiWidget\n  fText: TextGraphic\n  min*, max*, value*: float\n  precision*: range[0 .. 32]     ## value format precision (defaults to 0)\n  unit*: string                ## value format unit (defaults to '%')\n  decimalSep*: char            ## value format decimal separator (defaults to '.')\n  direction*: Direction\n  dim*: Dim\n  outline*: Dim                ## outline border size\n  bgColor*, fgColor*: Color\n  bgGraphic*, fgGraphic*: TextureGraphic\n  reverseX*, reverseY*: bool\n
\n
\n\n\n
\n\n
\n
\n

Procs

\n
\n\n
proc init(bar: GuiProgressBar; dim: Dim; bgColor, fgColor: Color; font: Font;\n         bgGraphic, fgGraphic: TextureGraphic) {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n

GuiProgressBar initialization.

\n

dim bar's dimensions.

\n

bgColor, fgColor background (empty) and foreground (full) colors.

\n

font info text font. Might be nil.

\n

bgGraphic, fgGraphic background (empty) and foreground (full) textures that replace bgColor and fgColor if specified.

\n\n\n
\n\n
proc newProgressBar(dim: Dim; bgColor: Color; fgColor: Color; font: Font = nil;\n                   bgGraphic: TextureGraphic = nil; fgGraphic: TextureGraphic = nil): GuiProgressBar {...}{.\n    raises: [Exception], tags: [RootEffect].}
\n
\n

Create a new GuiProgressBar.

\n

dim bar's dimensions.

\n

bgColor, fgColor background (empty) and foreground (full) colors.

\n

font info text font. Might be nil.

\n

bgGraphic, fgGraphic background (empty) and foreground (full) textures that replace bgColor and fgColor if specified.

\n\n\n
\n\n
proc renderGuiProgressBar(bar: GuiProgressBar) {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n

Default progress bar render procedure.

\n

Call it from your progress bar render method.

\n\n\n
\n\n
\n
\n

Methods

\n
\n\n
method render(bar: GuiProgressBar) {...}{.raises: [Exception], tags: [RootEffect].}
\n
\n\n\n
\n\n
\n\n
\n
\n\n
\n
\n \n
\n Made with Nim. Generated: 2019-01-21 14:59:39 UTC\n
\n
\n
\n
\n\n\n\n" }, { "path": "docs/docs/gui/radio.html", "content": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\nradio\n\n\n\n\n\n\n\n\n
\n
\n

radio

\n
\n
\n
\n
    \n
\n
\n
\n Search: \n
\n
\n Group by:\n \n
\n \n\n
\n
\n
\n

\n \n
\n

Types

\n
\n\n
GuiRadioGroup = ref object of Entity\n  list*: seq[GuiWidget]\n
\n
\n\n\n
\n\n
GuiRadioButton = ref object of GuiButton\n  group*: GuiRadioGroup\n
\n
\n\n\n
\n\n
\n
\n

Procs

\n
\n\n
proc init(radiogroup: GuiRadioGroup) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc newGuiRadioGroup(): GuiRadioGroup {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc toggle(radiogroup: GuiRadioGroup; target: GuiWidget) {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\nToggle a target element of the radiogroup. \n\n
\n\n
proc init(radiobutton: GuiRadioButton; group: GuiRadioGroup; graphic: Graphic;\n         image: Graphic = nil; circle: bool = false) {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n

GuiRadioButton initialization.

\n

group GuiRadioGroup the radiobutton belongs to.

\n

graphic, image, circle See "gui/button.nim" initialization docs.

\n\n\n
\n\n
proc newGuiRadioButton(group: GuiRadioGroup; graphic: Graphic; image: Graphic = nil;\n                      circle: bool = false): GuiRadioButton {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n

Create a new GuiRadioButton.

\n

group GuiRadioGroup the radiobutton belongs to.

\n

graphic, image, circle See "gui/button.nim" initialization docs.

\n\n\n
\n\n
proc setToggled(radiobutton: GuiRadioButton; val: bool) {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\nToggle radiobutton to a given state. \n\n
\n\n
\n
\n

Methods

\n
\n\n
method toggled=(radiobutton: GuiRadioButton; val: bool) {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
\n\n
\n
\n\n
\n
\n \n
\n Made with Nim. Generated: 2019-01-21 14:59:39 UTC\n
\n
\n
\n
\n\n\n\n" }, { "path": "docs/docs/gui/textinput.html", "content": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\ntextinput\n\n\n\n\n\n\n\n\n
\n
\n

textinput

\n
\n
\n
\n
    \n
\n
\n
\n Search: \n
\n
\n Group by:\n \n
\n \n\n
\n
\n
\n

\n \n
\n

Types

\n
\n\n
GuiTextInput = ref object of GuiWidget\n  text*: TextField\n  textPos*: Coord              ## Relative text position\n  keysBackspace*, keysDelete*, keysLeft*, keysRight*, keysToFirst*, keysToLast*,\n  keysDone*: seq[Keycode]\n
\n
\n\n\n
\n\n
\n
\n

Procs

\n
\n\n
proc init(input: GuiTextInput; graphic: Graphic; font: Font) {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n

GuiTextInput initialization.

\n

grapic 2x2 input field graphic: default, focused, pressed (active), disabled.

\n

font Font object for text rendering.

\n\n\n
\n\n
proc newGuiTextInput(graphic: Graphic; font: Font): GuiTextInput {...}{.\n    raises: [Exception], tags: [RootEffect].}
\n
\n

Create a new GuiTextInput.

\n

grapic 2x2 input field graphic: default, focused, pressed (active), disabled.

\n

font Font object for text rendering.

\n\n\n
\n\n
proc eventGuiTextInput(input: GuiTextInput; e: Event) {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
proc enter(input: GuiTextInput) {...}{.raises: [Exception], tags: [RootEffect].}
\n
\nStart text entry mode. \n\n
\n\n
proc click(input: GuiTextInput; mb: MouseButton) {...}{.inline, raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
proc renderGuiTextInput(input: GuiTextInput) {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n

Default text input render procedure.

\n

Call it from your text input render method.

\n\n\n
\n\n
\n
\n

Methods

\n
\n\n
method event(input: GuiTextInput; e: Event) {...}{.raises: [Exception], tags: [RootEffect].}
\n
\n\n\n
\n\n
method state=(input: GuiTextInput; val: GuiState) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
method onClick(input: GuiTextInput; mb: MouseButton) {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method render(input: GuiTextInput) {...}{.raises: [Exception], tags: [RootEffect].}
\n
\n\n\n
\n\n
\n\n
\n
\n\n
\n
\n \n
\n Made with Nim. Generated: 2019-01-21 14:59:40 UTC\n
\n
\n
\n
\n\n\n\n" }, { "path": "docs/docs/gui/widget.html", "content": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\nwidget\n\n\n\n\n\n\n\n\n
\n
\n

widget

\n
\n
\n
\n
    \n
\n
\n
\n Search: \n
\n
\n Group by:\n \n
\n \n\n
\n
\n
\n

\n \n
\n

Types

\n
\n\n
GuiAction = proc (widget: GuiWidget)
\n
\n\n\n
\n\n
GuiState {...}{.pure.} = enum\n  defaultUp, defaultDown, focusedUp, focusedDown, disabledUp, disabledDown
\n
\n\n\n
\n\n
GuiWidget = ref object of Entity\n  fState: GuiState\n  fWasPressed: MouseState\n  actions*: seq[GuiAction]     ## A list of action to perform on click.\n  mbAllow*: MouseState         ## Mouse buttons allowed for interaction.\n  toggle*, fToggled: bool       ## If `true`, the widget is in toggle on/off mode.\n
\n
\n\n\n
\n\n
\n
\n

Procs

\n
\n\n
proc init(widget: GuiWidget) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc newGuiWidget(): GuiWidget {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc state(widget: GuiWidget): GuiState {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc clickAction(widget: GuiWidget) {...}{.raises: [Exception], tags: [RootEffect].}
\n
\n\n\n
\n\n
proc setState(widget: GuiWidget; val: GuiState) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc setToggled(widget: GuiWidget; val: bool) {...}{.raises: [Exception], tags: [RootEffect].}
\n
\n\n\n
\n\n
proc disable(widget: GuiWidget) {...}{.raises: [Exception], tags: [RootEffect].}
\n
\n\n\n
\n\n
proc enable(widget: GuiWidget) {...}{.raises: [Exception], tags: [RootEffect].}
\n
\n\n\n
\n\n
proc eventGuiWidget(widget: GuiWidget; e: Event) {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
\n
\n

Methods

\n
\n\n
method onPress(widget: GuiWidget) {...}{.base, raises: [], tags: [].}
\n
\n\n\n
\n\n
method onClick(widget: GuiWidget; mb = MouseButton.left) {...}{.base, raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method state=(widget: GuiWidget; val: GuiState) {...}{.base, raises: [], tags: [].}
\n
\n\n\n
\n\n
method toggled=(widget: GuiWidget; val: bool) {...}{.base, raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method press(widget: GuiWidget) {...}{.base, raises: [Exception], tags: [RootEffect].}
\n
\n\n\n
\n\n
method release(widget: GuiWidget) {...}{.base, raises: [Exception], tags: [RootEffect].}
\n
\n\n\n
\n\n
method event(widget: GuiWidget; e: Event) {...}{.raises: [Exception], tags: [RootEffect].}
\n
\n\n\n
\n\n
\n
\n

Templates

\n
\n\n
template isUp(state: GuiState): bool
\n
\n\n\n
\n\n
template isDown(state: GuiState): bool
\n
\n\n\n
\n\n
template isFocused(state: GuiState): bool
\n
\n\n\n
\n\n
template isDisabled(state: GuiState): bool
\n
\n\n\n
\n\n
template isEnabled(state: GuiState): bool
\n
\n\n\n
\n\n
template toggled(widget: GuiWidget): bool
\n
\n\n\n
\n\n
template pressWidget(widget: GuiWidget)
\n
\n\n\n
\n\n
template releaseWidget(widget: GuiWidget)
\n
\n\n\n
\n\n
\n\n
\n
\n\n
\n
\n \n
\n Made with Nim. Generated: 2019-01-21 14:59:40 UTC\n
\n
\n
\n
\n\n\n\n" }, { "path": "docs/docs/indexedimage.html", "content": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\nindexedimage\n\n\n\n\n\n\n\n\n
\n
\n

indexedimage

\n
\n
\n
\n
    \n
\n
\n
\n Search: \n
\n
\n Group by:\n \n
\n \n\n
\n
\n
\n

\n \n
\n

Types

\n
\n\n
Palette = ptr sdl.Palette
\n
\n\n\n
\n\n
IndexedImage = ref object of RootObj\n  fSurface: Surface            ## Source surface\n
\n
\n\n\n
\n\n
\n
\n

Procs

\n
\n\n
proc free(palette: Palette) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc init(palette: var Palette; ncolors: int) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc ncolors(palette: Palette): int {...}{.raises: [], tags: [].}
\n
\nGet the number of colors in palette. \n\n
\n\n
proc `[]`(palette: Palette; i: int): Color {...}{.raises: [IndexError], tags: [].}
\n
\nGet the i'th color from the palette. \n\n
\n\n
proc `[]=`(palette: Palette; i: int; colors: openArray[Color]) {...}{.raises: [IndexError],\n    tags: [].}
\n
\nChange colors in the palette starting with i'th color. \n\n
\n\n
proc `[]=`(palette: Palette; i: int; color: Color) {...}{.raises: [IndexError], tags: [].}
\n
\nChange i'th color in the palette. \n\n
\n\n
proc free(image: IndexedImage) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc init(image: IndexedImage) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc load(image: IndexedImage; file: string): bool {...}{.raises: [], tags: [].}
\n
\nLoad image``graphic source from a ``file. \n\n
\n\n
proc load(image: IndexedImage; src: ptr RWops; freeSrc: bool = true): bool {...}{.raises: [],\n    tags: [].}
\n
\nLoad image``graphic source from a ``src RWops. \n\n
\n\n
proc newIndexedImage(): IndexedImage {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc newIndexedImage(file: string): IndexedImage {...}{.raises: [], tags: [].}
\n
\nCreate a new IndexedImage and load it from a file. \n\n
\n\n
proc newIndexedImage(src: ptr RWops; freeSrc: bool = true): IndexedImage {...}{.raises: [],\n    tags: [].}
\n
\nCreate a new IndexedImage and load it from a src RWops. \n\n
\n\n
proc palette(image: IndexedImage): Palette {...}{.inline, raises: [], tags: [].}
\n
\nGet the current palette of the image. \n\n
\n\n
proc palette=(image: IndexedImage; palette: Palette) {...}{.inline, raises: [], tags: [].}
\n
\nAssign a new palette to the image. \n\n
\n\n
proc render(image: IndexedImage): Texture {...}{.inline, raises: [], tags: [].}
\n
\nReturn a new Texture created from indexed image. \n\n
\n\n
\n\n
\n
\n\n
\n
\n \n
\n Made with Nim. Generated: 2019-01-21 14:58:35 UTC\n
\n
\n
\n
\n\n\n\n" }, { "path": "docs/docs/input.html", "content": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\ninput\n\n\n\n\n\n\n\n\n
\n
\n

input

\n
\n
\n
\n
    \n
\n
\n
\n Search: \n
\n
\n Group by:\n \n
\n \n\n
\n
\n
\n

\n \n
\n

Types

\n
\n\n
MouseButton {...}{.size: 4, pure.} = enum\n  left = sdl.ButtonLeft, middle = sdl.ButtonMiddle, right = sdl.ButtonRight,\n  x1 = sdl.ButtonX1, x2 = sdl.ButtonX2
\n
\n\nMouse buttons. \n\n
\n\n
MouseState = int32
\n
\n\n\n
\n\n
JoyAxis = range[low(int16) .. high(int16)]
\n
\n\n\n
\n\n
JoyBall = CoordInt
\n
\n\n\n
\n\n
JoyHat = sdl.HatPosition
\n
\n\n\n
\n\n
GeneralInputKeyboard = object\n  key*: Scancode\n
\n
\n\n\n
\n\n
GeneralInputDirection = enum\n  dirX, dirY
\n
\n\n\n
\n\n
GeneralInputMouseKind = enum\n  mButton, mMove
\n
\n\n\n
\n\n
GeneralInputMouse = object\n  case kind*: GeneralInputMouseKind\n  of mButton:\n    button*: MouseButton\n  of mMove:\n    direction*: GeneralInputDirection\n
\n
\n\n\n
\n\n
GeneralInputJoystickKind = enum\n  jButton, jAxis, jBall, jHat
\n
\n\n\n
\n\n
GeneralInputJoystick = object\n  guid*: JoystickGUID\n  case kind*: GeneralInputJoystickKind\n  of jButton:\n    button*: int\n  of jAxis:\n    axis*: int\n  of jBall:\n      ball*: int\n      ballDirection*: GeneralInputDirection\n\n  of jHat:\n      hat*: int\n      hatPosition*: HatPosition\n\n
\n
\n\n\n
\n\n
GeneralInputKind = enum\n  giKeyboard, giMouse, giJoystick
\n
\n\n\n
\n\n
GeneralInput = object\n  case kind*: GeneralInputKind\n  of giKeyboard:\n      keyboard*: GeneralInputKeyboard\n\n  of giMouse:\n      mouse*: GeneralInputMouse\n\n  of giJoystick:\n      joystick*: GeneralInputJoystick\n\n
\n
\n\n\n
\n\n
InputMap = OrderedTableRef[string, GeneralInput]
\n
\n\n\n
\n\n
\n
\n

Procs

\n
\n\n
proc initKeyboard() {...}{.raises: [], tags: [].}
\n
\n

Clear the buffers.

\n

Called automatically from the main game cycle.

\n\n\n
\n\n
proc updateKeyboard(event: Event) {...}{.raises: [], tags: [].}
\n
\nCalled automatically from the main game cycle. \n\n
\n\n
proc down(scancodes: openArray[Scancode]): bool {...}{.raises: [], tags: [].}
\n
\nCheck if any scancode in the scancodes array is down. \n\n
\n\n
proc down(keymods: openArray[Keymod]): bool {...}{.raises: [], tags: [].}
\n
\nCheck if any keymod in the keymodes array is down. \n\n
\n\n
proc pressed(scancodes: openArray[Scancode]): bool {...}{.raises: [], tags: [].}
\n
\nCheck if any scancode in the scancodes array was just pressed. \n\n
\n\n
proc released(scancodes: openArray[Scancode]): bool {...}{.raises: [], tags: [].}
\n
\nCheck if any scancode in the scancodes array was just released. \n\n
\n\n
proc clearPressed(scancode: Scancode) {...}{.raises: [], tags: [].}
\n
\nRemove scancode from pressed keys list. \n\n
\n\n
proc clearReleased(scancode: Scancode) {...}{.raises: [], tags: [].}
\n
\nRemove scancode from released keys list. \n\n
\n\n
proc initMouse() {...}{.raises: [], tags: [].}
\n
\n

Clear the buffers.

\n

Called automatically from the main game cycle.

\n\n\n
\n\n
proc updateMouse(event: Event) {...}{.raises: [], tags: [].}
\n
\nCalled automatically from the main game cycle. \n\n
\n\n
proc joyIsOpened(id: int): bool {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc getId(guid: JoystickGUID): int {...}{.raises: [], tags: [].}
\n
\nReturn the index of a joystick with a corresponding guid, or -1 otherwise. \n\n
\n\n
proc joyGuid(id: int): JoystickGUID {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc openJoystick(id: int): bool {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc closeJoystick(id: int): bool {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc initJoysticks() {...}{.raises: [], tags: [].}
\n
\n

Init the joysticks sequence.

\n

Called automatically from the main game cycle.

\n\n\n
\n\n
proc updateJoysticks(event: Event) {...}{.raises: [], tags: [].}
\n
\nCalled automatically from the main game cycle. \n\n
\n\n
proc joyName(joystick: int): string {...}{.raises: [], tags: [].}
\n
\nReturn the name of the joystick, or an empty string otherwise. \n\n
\n\n
proc joyNumButtons(joystick: int): int {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc joyNumAxes(joystick: int): int {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc joyNumBalls(joystick: int): int {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc joyNumHats(joystick: int): int {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc joyDown(joystick: int; button: int): bool {...}{.raises: [], tags: [].}
\n
\n

Check if joystick button is down.

\n

joystick Joystick ID, or -1 to check every opened joystick.

\n

button Button ID.

\n\n\n
\n\n
proc joyPressed(joystick: int; button: int): bool {...}{.raises: [], tags: [].}
\n
\n

Check if joystick button was just pressed.

\n

joystick Joystick ID, or -1 to check every opened joystick.

\n

button Joystick button ID.

\n\n\n
\n\n
proc joyReleased(joystick: int; button: int): bool {...}{.raises: [], tags: [].}
\n
\n

Check if joystick button was just released.

\n

joystick Joystick ID, or -1 to check every opened joystick.

\n

button Joystick button ID.

\n\n\n
\n\n
proc joyAxis(joystick: int; axis: int): JoyAxis {...}{.raises: [], tags: [].}
\n
\n

Get joystick axis current position.

\n

joystick Joystick ID.

\n

axis Joystick axis ID.

\n\n\n
\n\n
proc joyBall(joystick: int; ball: int): JoyBall {...}{.raises: [], tags: [].}
\n
\n

Get joystick ball axis change since the last poll.

\n

joystick Joystick ID.

\n

ball Joystick ball ID.

\n\n\n
\n\n
proc joyHat(joystick: int; hat: int): JoyHat {...}{.raises: [], tags: [].}
\n
\n

Get joystick hat current position.

\n

joystick Joystick ID.

\n

hat Joystick hat ID.

\n\n\n
\n\n
proc newInputMap(): InputMap {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc addKey(map: InputMap; name: string; key: Scancode) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc addMouseButton(map: InputMap; name: string; button: MouseButton) {...}{.inline,\n    raises: [], tags: [].}
\n
\n\n\n
\n\n
proc addMouseMove(map: InputMap; name: string; direction: GeneralInputDirection) {...}{.\n    inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc addJoyButton(map: InputMap; name: string; guid: JoystickGUID; button: int) {...}{.inline,\n    raises: [], tags: [].}
\n
\n\n\n
\n\n
proc addJoyAxis(map: InputMap; name: string; guid: JoystickGUID; axis: int) {...}{.inline,\n    raises: [], tags: [].}
\n
\n\n\n
\n\n
proc addJoyBall(map: InputMap; name: string; guid: JoystickGUID; ball: int;\n               ballDirection: GeneralInputDirection) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc addJoyHat(map: InputMap; name: string; guid: JoystickGUID; hat: int;\n              hatPosition: HatPosition) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc `$`(gi: GeneralInput): string {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc load(map: InputMap; filename: string): bool {...}{.raises: [CsvError, Exception],\n    tags: [ReadIOEffect].}
\n
\n\n\n
\n\n
proc save(map: InputMap; filename: string): bool {...}{.raises: [IOError, Exception],\n    tags: [WriteIOEffect].}
\n
\n\n\n
\n\n
proc down(gi: GeneralInput): bool {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc pressed(gi: GeneralInput): bool {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc released(gi: GeneralInput): bool {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc movement(gi: GeneralInput): int {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
\n
\n

Converters

\n
\n\n
converter toInt(button: MouseButton): int32 {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
\n
\n

Templates

\n
\n\n
template down(scancode: Scancode): bool
\n
\nCheck if scancode (keyboard key) is down. \n\n
\n\n
template down(keymod: Keymod): bool
\n
\nCheck if keymod (keyboard mod key) is down. \n\n
\n\n
template pressed(scancode: Scancode): bool
\n
\nCheck if scancode (keyboard key) was just pressed. \n\n
\n\n
template released(scancode: Scancode): bool
\n
\nCheck if scancode (keyboard key) was just released. \n\n
\n\n
template name(keycode: Keycode): string
\n
\nReturn a human-readable name for the keycode. \n\n
\n\n
template name(scancode: Scancode): string
\n
\nReturn a human-readable name for the scancode. \n\n
\n\n
template set(state: var MouseState; button: int32; enable: bool = true)
\n
\nEnable or disable specific mouse button's flag in the given state. \n\n
\n\n
template mouse(): Coord2
\n
\nReturn current mouse position. \n\n
\n\n
template mouseWheel(): Coord
\n
\nReturn current mouse wheel motion. \n\n
\n\n
template mouseWheelFlipped(): bool
\n
\nReturn true if mouse wheel direction is flipped. \n\n
\n\n
template mouseRelative(enabled: bool): bool
\n
\nSet relative mouse mode. \n\n
\n\n
template mouseCapture(enabled: bool): bool
\n
\nCapture or release the mouse. \n\n
\n\n
template down(button: int32; state: MouseState = mBtn): bool
\n
\nCheck if mouse button is pressed. \n\n
\n\n
template down(button: MouseButton; state: MouseState = mBtn): bool
\n
\n\n\n
\n\n
template pressed(button: int32): bool
\n
\nCheck if mouse button was just pressed. \n\n
\n\n
template pressed(button: MouseButton): bool
\n
\n\n\n
\n\n
template released(button: int32): bool
\n
\nCheck if mouse button was just released. \n\n
\n\n
template released(button: MouseButton): bool
\n
\n\n\n
\n\n
template clearPressed(button: int32)
\n
\nRemove button from pressed buttons list. \n\n
\n\n
template clearPressed(button: MouseButton)
\n
\n\n\n
\n\n
template clearReleased(button: int32)
\n
\nRemove button from released buttons list. \n\n
\n\n
template clearReleased(button: MouseButton)
\n
\n\n\n
\n\n
template mbState(): MouseState
\n
\nReturn current mouse buttons state value. \n\n
\n\n
template cursorIsVisible(): bool
\n
\nReturn true if the system mouse cursor is visible, or false otherwise. \n\n
\n\n
template showCursor()
\n
\nShow the system mouse cursor. \n\n
\n\n
template hideCursor()
\n
\nHide the system mouse cursor. \n\n
\n\n
template toggleCursor()
\n
\nToggle the visibility of the system mouse cursor. \n\n
\n\n
\n\n
\n
\n\n
\n
\n \n
\n Made with Nim. Generated: 2019-01-21 14:58:36 UTC\n
\n
\n
\n
\n\n\n\n" }, { "path": "docs/docs/mosaic.html", "content": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\nmosaic\n\n\n\n\n\n\n\n\n
\n
\n

mosaic

\n
\n
\n
\n
    \n
\n
\n
\n Search: \n
\n
\n Group by:\n \n
\n \n\n
\n
\n
\n

\n \n
\n

Types

\n
\n\n
MosaicPattern = seq[seq[int]]
\n
\n\n\n
\n\n
Mosaic = ref object of RootObj\n  fSurface: Surface            ## Source surface\n  fDim: Dim                    ## Dimensions of the surface\n  tileDim*, offset*: Dim        ## \\\n                      ##  Dimensions of a single mosaic tile, and offset from the edge.\n
\n
\n\n\n
\n\n
RepeatPattern = seq[tuple[rows, cols: int, data: seq[int]]]
\n
\n\nRepeatPattern meaning:
RepeatPattern = seq[tuple[rows, cols: int, data: seq[int]]]
  • rows repeat this row rows times
    • \n
  • cols repeat this data sequence cols times,
    • \n
\n

gradually increasing the index.

\n
  • data for each item repeat increasing index item times.
    • \n
\n

Example:

\n
patternRepeat(@[\n  (1, 2, @[1, 2, 1]),\n  (2, 2, @[1, 2, 1]),\n  (1, 2, @[1, 2, 1]),\n])

will return:

\n
@[\n  @[0, 1, 1, 2, 3, 4, 4, 5],\n  @[6, 7, 7, 8, 9, 10, 10, 11],\n  @[6, 7, 7, 8, 9, 10, 10, 11],\n  @[12, 13, 13, 14, 15, 16, 16, 17]\n]
\n\n
\n\n
\n
\n

Procs

\n
\n\n
proc free(mosaic: Mosaic) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc init(mosaic: Mosaic) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc load(mosaic: Mosaic; file: string; tileDim: Dim; offset: Dim = (0, 0)): bool {...}{.\n    raises: [], tags: [].}
\n
\n

Load mosaic graphic source from a file.

\n

tileDim dimensions of a single mosaic tile.

\n

offset offset from the edge.

\n

Return true on success, or false otherwise.

\n\n\n
\n\n
proc load(mosaic: Mosaic; src: ptr RWops; tileDim: Dim; offset: Dim = (0, 0);\n         freeSrc: bool = true): bool {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc newMosaic(): Mosaic {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc newMosaic(file: string; tileDim: Dim; offset: Dim = (0, 0)): Mosaic {...}{.raises: [],\n    tags: [].}
\n
\n

Create a new Mosaic and load tileset from a file.

\n

tileDim the size of a single tile.

\n

offset offset from the edge of the tileset.

\n\n\n
\n\n
proc newMosaic(src: ptr RWops; tileDim: Dim; offset: Dim = (0, 0); freeSrc: bool = true): Mosaic {...}{.\n    raises: [], tags: [].}
\n
\n\n\n
\n\n
proc dim(mosaic: Mosaic): Dim {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc renderSurface(mosaic: Mosaic; pattern: MosaicPattern): Surface {...}{.raises: [],\n    tags: [].}
\n
\nReturn a new Surface created with mosaic tiles by a given pattern. \n\n
\n\n
proc render(mosaic: Mosaic; pattern: MosaicPattern): Texture {...}{.raises: [], tags: [].}
\n
\nReturn a new Texture created with mosaic tiles by a given pattern. \n\n
\n\n
proc patternRepeat(repeat: RepeatPattern): MosaicPattern {...}{.raises: [], tags: [].}
\n
\n

Generate a repeating pattern. Useful for generating GUI elements of different sizes with Mosaic.

\n

See also: RepeatPattern type.

\n\n\n
\n\n
proc patternStretchBorder(w, h: int; nx = 2; ny = 3): MosaicPattern {...}{.raises: [], tags: [].}
\n
\n

Generate a repeating pattern by repeating border items of 3x3 matrix (used for GUI buttons, etc.)

\n

w, h strethed parts repeat count.

\n

nx, ny number of elements in the matrix.

\n\n\n
\n\n
\n\n
\n
\n\n
\n
\n \n
\n Made with Nim. Generated: 2019-01-21 14:58:36 UTC\n
\n
\n
\n
\n\n\n\n" }, { "path": "docs/docs/nimgame.html", "content": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\nnimgame\n\n\n\n\n\n\n\n\n
\n
\n

nimgame

\n
\n
\n
\n
    \n
\n
\n
\n Search: \n
\n
\n Group by:\n \n
\n \n\n
\n
\n
\n

\n \n
\n

Types

\n
\n\n
Game = ref object\n  fWindow: sdl.Window\n  fSize: Dim\n  fIcon: sdl.Surface\n  fScene: Scene                ## Current scene\n
\n
\n\n\n
\n\n
\n
\n

Vars

\n
\n\n
game: Game
\n
\nGlobal game variable\n\n
\n\n
\n
\n

Procs

\n
\n\n
proc free(game: Game) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc init(game: Game; w, h: int; title = "Nimgame2";\n         bgColor = sdl.Color(r: 0, g: 0, b: 0, a: 255); windowFlags: uint32 = 0;\n         rendererFlags: uint32 = 0x00000002 or 0x00000004;\n         scaleQuality: range[0 .. 2] = 0; integerScale: bool = false;\n         iconSurface: sdl.Surface = nil; icon: string = "";\n         imageFlags: cint = img.InitPNG; mixerFlags: cint = mix.InitOGG;\n         mixerChannels: int = 32): bool {...}{.raises: [], tags: [TimeEffect].}
\n
\n

Init game.

\n

w, h window dimensions

\n

title window title

\n

bgColor window background color

\n

windowFlags sdl window flags

\n

rendererFlags sdl renderer flags

\n

scaleQuality scale quality (pixel sampling)

\n

integerScale force integer scale only

\n

iconSurface window icon surface (has priority over icon)

\n

icon window icon file name

\n

imageFlags sdl_image flags

\n

mixerFlags sdl_mixer flags

\n

mixerChannels Number of channels to allocate for mixing.

\n

Return true on success, false otherwise.

\n\n\n
\n\n
proc newGame(): Game {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc title(game: Game): string {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc title=(game: Game; title: string) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc pos(game: Game): Coord {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc pos=(game: Game; pos: Coord) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc centrify(game: Game; centerX = true; centerY = true) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc windowSize(game: Game): Dim {...}{.raises: [], tags: [].}
\n
\nReturn game window dimensions. \n\n
\n\n
proc windowSize=(game: Game; dim: Dim) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc minSize(game: Game): Dim {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc minSize=(game: Game; dim: Dim) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc maxSize(game: Game): Dim {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc maxSize=(game: Game; dim: Dim) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc setBordered(game: Game; enabled: bool) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc setResizable(game: Game; enabled: bool) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc show(game: Game) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc hide(game: Game) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc focus(game: Game) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc maximize(game: Game) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc minimize(game: Game) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc restore(game: Game) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc size(game: Game): Dim {...}{.inline, raises: [], tags: [].}
\n
\nGet logical size of the game renderer. \n\n
\n\n
proc scale(game: Game): Coord {...}{.inline, raises: [], tags: [].}
\n
\nReturn the scale of the game renderer. \n\n
\n\n
proc icon(game: Game): Surface {...}{.inline, raises: [], tags: [].}
\n
\nReturn game icon surface. \n\n
\n\n
proc icon=(game: Game; icon: string) {...}{.inline, raises: [], tags: [].}
\n
\nLoad new game icon from the icon file name. \n\n
\n\n
proc icon=(game: Game; surface: Surface) {...}{.inline, raises: [], tags: [].}
\n
\nSet new game icon surface. \n\n
\n\n
proc scene(game: Game): Scene {...}{.inline, raises: [], tags: [].}
\n
\nReturn current game scene. \n\n
\n\n
proc scene=(game: Game; val: Scene) {...}{.raises: [Exception], tags: [RootEffect].}
\n
\nSet a new game scene. \n\n
\n\n
proc viewport(game: Game): Rect {...}{.raises: [], tags: [].}
\n
\nGet current viewport. \n\n
\n\n
proc viewport=(game: Game; rect: Rect) {...}{.raises: [], tags: [].}
\n
\nSet current viewport. \n\n
\n\n
proc resetViewport(game: Game) {...}{.raises: [], tags: [].}
\n
\nSet default viewport. \n\n
\n\n
proc run(game: Game) {...}{.raises: [Exception], tags: [RootEffect].}
\n
\nStart the game. \n\n
\n\n
\n\n
\n
\n\n
\n
\n \n
\n Made with Nim. Generated: 2019-01-21 14:58:37 UTC\n
\n
\n
\n
\n\n\n\n" }, { "path": "docs/docs/perspectiveimage.html", "content": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\nperspectiveimage\n\n\n\n\n\n\n\n\n
\n
\n

perspectiveimage

\n
\n
\n
\n
    \n
\n
\n
\n Search: \n
\n
\n Group by:\n \n
\n \n\n
\n
\n
\n

\n \n
\n

Types

\n
\n\n
PerspectiveDirection = enum\n  pdHor, pdVer
\n
\n\n\n
\n\n
PerspectiveImage = ref object of RootObj\n  fDim: Dim\n  fSurface: Surface            ## Source surface\n
\n
\n\n\n
\n\n
\n
\n

Procs

\n
\n\n
proc free(image: PerspectiveImage) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc init(image: PerspectiveImage) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc load(image: PerspectiveImage; file: string): bool {...}{.raises: [], tags: [].}
\n
\nLoad image graphic source from a file. \n\n
\n\n
proc load(image: PerspectiveImage; src: ptr RWops; freeSrc: bool = true): bool {...}{.\n    raises: [], tags: [].}
\n
\nLoad image graphic source from a src RWops. \n\n
\n\n
proc newPerspectiveImage(): PerspectiveImage {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc newPerspectiveImage(file: string): PerspectiveImage {...}{.raises: [], tags: [].}
\n
\nCreate a new PerspectiveImage and load it from a file. \n\n
\n\n
proc newPerspectiveImage(src: ptr RWops; freeSrc: bool = true): PerspectiveImage {...}{.\n    raises: [], tags: [].}
\n
\nCreate a new PerspectiveImage and load it from a src RWops. \n\n
\n\n
proc dim(image: PerspectiveImage): Dim {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc render(image: PerspectiveImage; direction: PerspectiveDirection;\n           sizeFrom, sizeTo: int; sizeNormal: int = 0; shift: float = 0.5): Texture {...}{.\n    raises: [], tags: [].}
\n
\n

direction (pdHor or pdVer) direction of perspective axis.

\n

sizeFrom, sizeTo target scaled size (left and right for the pdHor, or top and bottom for the pdVer).

\n

sizeNormal scaled size of the normal axis.

\n

shift perspective shift (0.5 is center symmetry).

\n

Return a new Texture created from the image.

\n\n\n
\n\n
\n\n
\n
\n\n
\n
\n \n
\n Made with Nim. Generated: 2019-01-21 14:58:37 UTC\n
\n
\n
\n
\n\n\n\n" }, { "path": "docs/docs/plugin/mpeggraphic.html", "content": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\nmpeggraphic\n\n\n\n\n\n\n\n\n
\n
\n

mpeggraphic

\n
\n
\n
\n
    \n
\n
\n
\n Search: \n
\n
\n Group by:\n \n
\n \n\n
\n
\n
\n

Note: mpg123 dynamic library should be available in the system.

\n \n
\n

Types

\n
\n\n
MpegVolume = range[0 .. 100]
\n
\n\n\n
\n\n
MpegGraphic = ref object of TextureGraphic\n  fInfo: smpeg.Info\n  fSmpeg: smpeg.Smpeg\n  fFrame: smpeg.Frame\n  fMutex: sdl.Mutex\n  fRect: sdl.Rect\n  fVideo, fAudio, fLoop: bool\n  fVolume: MpegVolume\n  fUpdated: bool\n
\n
\n\nSee sdl2/mpeg documentation for the details of implementation.\n\n
\n\n
\n
\n

Procs

\n
\n\n
proc free(graphic: MpegGraphic) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc load(graphic: MpegGraphic; filename: string): bool {...}{.raises: [], tags: [].}
\n
\n

Load MPEG movie file.

\n

Return true on success, false otherwise.

\n\n\n
\n\n
proc load(graphic: MpegGraphic; src: ptr RWops; freeSrc: bool = true): bool {...}{.raises: [],\n    tags: [].}
\n
\n

Load MPEG movie file.

\n

Return true on success, false otherwise.

\n\n\n
\n\n
proc newMpegGraphic(filename: string): MpegGraphic {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc newMpegGraphic(src: ptr RWops; freeSrc: bool): MpegGraphic {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc drawMpegGraphic(graphic: MpegGraphic; pos: Coord = (0.0, 0.0); angle: Angle = 0.0;\n                    scale: Scale = 1.0; center: Coord = (0.0, 0.0);\n                    flip: Flip = Flip.none;\n                    region: Rect = Rect(x: 0, y: 0, w: 0, h: 0)) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc video(graphic: MpegGraphic): bool {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc video=(graphic: MpegGraphic; on: bool) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc audio(graphic: MpegGraphic): bool {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc audio=(graphic: MpegGraphic; on: bool) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc playing(graphic: MpegGraphic): bool {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc volume(graphic: MpegGraphic): MpegVolume {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc volume=(graphic: MpegGraphic; volume: MpegVolume) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc loop(graphic: MpegGraphic): bool {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc loop=(graphic: MpegGraphic; on: bool) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc play(graphic: MpegGraphic) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc pause(graphic: MpegGraphic) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc stop(graphic: MpegGraphic) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc rewind(graphic: MpegGraphic) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc seek(graphic: MpegGraphic; bytes: int) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc skip(graphic: MpegGraphic; seconds: float) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc currentFrame(graphic: MpegGraphic): int {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc currentTime(graphic: MpegGraphic): float {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc totalTime(graphic: MpegGraphic): float {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc renderFrame(graphic: MpegGraphic; frame: int) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
\n
\n

Methods

\n
\n\n
method w(graphic: MpegGraphic): int {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
method h(graphic: MpegGraphic): int {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
method dim(graphic: MpegGraphic): Dim {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
method draw(graphic: MpegGraphic; pos: Coord = (0.0, 0.0); angle: Angle = 0.0;\n           scale: Scale = 1.0; center: Coord = (0.0, 0.0); flip: Flip = Flip.none;\n           region: Rect = Rect(x: 0, y: 0, w: 0, h: 0)) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
\n\n
\n
\n\n
\n
\n \n
\n Made with Nim. Generated: 2019-01-21 15:00:52 UTC\n
\n
\n
\n
\n\n\n\n" }, { "path": "docs/docs/plugin/tar.html", "content": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\ntar\n\n\n\n\n\n\n\n\n
\n
\n

tar

\n
\n
\n
\n
    \n
\n
\n
\n Search: \n
\n
\n Group by:\n \n
\n \n\n
\n
\n
\n

Simple utility for reading TAR archives and loading their contents into sdl.RWops. Based on dxTarRead by Dmitry Hrabrov a.k.a. DeXPeriX.

\n

Original source link: https://github.com/DeXP/dxTarRead/blob/master/dxTarRead.c

\n

\n
\n

Types

\n
\n\n
TarFile = object\n  data: ptr uint8\n  size: int\n  contents: seq[tuple[name: cstring, size: int, data: ptr uint8]]\n
\n
\n\n\n
\n\n
\n
\n

Procs

\n
\n\n
proc contents(tar: TarFile): seq[string] {...}{.raises: [], tags: [].}
\n
\nReturn a sequence of filenames (including paths) inside the tar. \n\n
\n\n
proc contents(tar: TarFile; sub: string; pos: int = 0): seq[string] {...}{.raises: [], tags: [].}
\n
\nReturn a sequence of filenames (including paths), which start with sub string, starting at pos index, inside the tar. Useful for getting all files inside one archived directory. \n\n
\n\n
proc close(tar: var TarFile) {...}{.raises: [Exception], tags: [].}
\n
\n\n\n
\n\n
proc open(tar: var TarFile; filename: string): bool {...}{.raises: [Exception, IOError],\n    tags: [ReadIOEffect].}
\n
\n

Open uncompressed TAR archive (eg. "archive.tar").

\n

Return true on success, or false otherwise (or if no usable files found inside).

\n\n\n
\n\n
proc openz(tar: var TarFile; filename: string): bool {...}{.raises: [Exception, IOError,\n    OutOfMemError, ZlibStreamError, OverflowError], tags: [ReadIOEffect].}
\n
\n

Open compressed TAR archive (e.g. "archive.tar.gz").

\n

Return true on success, or false otherwise (or if no usable files found inside).

\n\n\n
\n\n
proc index(tar: TarFile; filename: string): int {...}{.raises: [], tags: [].}
\n
\nReturn index of filename in tar file, or -1 if not found. \n\n
\n\n
proc read(tar: TarFile; filename: string): ptr RWops {...}{.raises: [], tags: [].}
\n
\nRead filename from tar and return its content as a new RWops pointer. \n\n
\n\n
\n
\n

Templates

\n
\n\n
template exists(tar: TarFile; filename: string): bool
\n
\n\n\n
\n\n
\n\n
\n
\n\n
\n
\n \n
\n Made with Nim. Generated: 2019-01-21 15:00:53 UTC\n
\n
\n
\n
\n\n\n\n" }, { "path": "docs/docs/plugin/zzip.html", "content": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\nzzip\n\n\n\n\n\n\n\n\n
\n
\n

zzip

\n
\n
\n
\n
    \n
\n
\n
\n Search: \n
\n
\n Group by:\n \n
\n \n\n
\n
\n
\n

You should be able to drop it in the place of a sdl.rwFromFile(). Then go to X/share/myapp and do ```cd graphics && zip -9r ../graphics.zip .``` and rename the graphics/ subfolder - and still all your files are found: a filepath like X/shared/graphics/game/greetings.bmp will open X/shared/graphics.zip and return the zipped file game/greetings.bmp in the zip-archive (for reading that is).

\n

See original code at http://zziplib.sourceforge.net/zzip-sdl-rwops.html

\n

Note: zzip dynamic library should be available in the system.

\n

\n
\n

Procs

\n
\n\n
proc zzipSeek(context: ptr RWops; offset: int64; whence: cint): int64 {...}{.cdecl, raises: [],\n    tags: [].}
\n
\n\n\n
\n\n
proc zzipRead(context: ptr RWops; buf: pointer; size: csize; maxnum: csize): csize {...}{.cdecl,\n    raises: [], tags: [].}
\n
\n\n\n
\n\n
proc zzipWrite(context: ptr RWops; buf: pointer; size: csize; num: csize): csize {...}{.cdecl,\n    raises: [], tags: [].}
\n
\n\n\n
\n\n
proc zzipClose(context: ptr RWops): cint {...}{.cdecl, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc rwFromZZip(file, mode: string = "r"): ptr RWops {...}{.raises: [OutOfMemError], tags: [].}
\n
\n\n\n
\n\n
\n\n
\n
\n\n
\n
\n \n
\n Made with Nim. Generated: 2019-01-21 15:00:53 UTC\n
\n
\n
\n
\n\n\n\n" }, { "path": "docs/docs/private/collider.html", "content": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\ncollider\n\n\n\n\n\n\n\n\n
\n
\n

collider

\n
\n
\n
\n
    \n
\n
\n
\n Search: \n
\n
\n Group by:\n \n
\n \n\n
\n
\n
\n

Do not import this file. It is included in entity.nim automatically.

\n
\n

Procs

\n
\n\n
proc renderCollider(a: Collider) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc updateFarthest(p: PolyCollider) {...}{.inline, raises: [], tags: [].}
\n
\nCall this procedure any time you changed points' coordinates. \n\n
\n\n
proc init(g: GroupCollider; parent: Entity) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc newGroupCollider(parent: Entity): GroupCollider {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc checkCollisions(entity: Entity; list: seq[Entity]) {...}{.raises: [], tags: [].}
\n
\nTrigger onCollide method of entity with a given list of targets. \n\n
\n\n
proc isColliding(entity: Entity; list: seq[Entity]): bool {...}{.raises: [], tags: [].}
\n
\nReturn true if entity collides with one of the elements in the given list, or false if no collisions occurs. \n\n
\n\n
proc willCollide(entity: Entity; pos: Coord; rot: Angle; scale: Scale; list: seq[Entity]): bool {...}{.\n    raises: [], tags: [].}
\n
\nReturn true if entity will collide with one of the elements in the given list, if entity's coordinates or dimentsions will change. \n\n
\n\n
\n
\n

Methods

\n
\n\n
method collide(pos: Coord; a: Collider): bool {...}{.base, inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
method render(a: Collider) {...}{.base, raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(a: Collider; pos: Coord): bool {...}{.base, inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(a1, a2: Collider): bool {...}{.base, inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(a: Collider; b: BoxCollider): bool {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(a: Collider; c: CircleCollider): bool {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(a: Collider; d: LineCollider): bool {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(a: Collider; p: PolyCollider): bool {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(a: Collider; g: GroupCollider): bool {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(b: BoxCollider; pos: Coord): bool {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(b: BoxCollider; a: Collider): bool {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(b: BoxCollider; p: PolyCollider): bool {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(b: BoxCollider; g: GroupCollider): bool {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(c: CircleCollider; pos: Coord): bool {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(c: CircleCollider; a: Collider): bool {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(c: CircleCollider; b: BoxCollider): bool {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(c: CircleCollider; p: PolyCollider): bool {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(c: CircleCollider; g: GroupCollider): bool {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(d: LineCollider; pos: Coord): bool {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(d: LineCollider; a: Collider): bool {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(d: LineCollider; b: BoxCollider): bool {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(d: LineCollider; c: CircleCollider): bool {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(d: LineCollider; p: PolyCollider): bool {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(d: LineCollider; g: GroupCollider): bool {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(p: PolyCollider; pos: Coord): bool {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(p: PolyCollider; a: Collider): bool {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(p: PolyCollider; b: BoxCollider): bool {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(p: PolyCollider; c: CircleCollider): bool {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(p: PolyCollider; d: LineCollider): bool {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(p1, p2: PolyCollider): bool {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(p: LineCollider; g: GroupCollider): bool {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
method render(g: GroupCollider) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(g: GroupCollider; pos: Coord): bool {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(g: GroupCollider; a: Collider): bool {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(g: GroupCollider; b: BoxCollider): bool {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(g: GroupCollider; c: CircleCollider): bool {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(g: GroupCollider; d: LineCollider): bool {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
method collide(g: GroupCollider; p: PolyCollider): bool {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
\n
\n

Templates

\n
\n\n
template collide(pos1, pos2: Coord): bool
\n
\n\n\n
\n\n
\n\n
\n
\n\n
\n
\n \n
\n Made with Nim. Generated: 2019-01-21 15:00:26 UTC\n
\n
\n
\n
\n\n\n\n" }, { "path": "docs/docs/procgraphic.html", "content": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\nprocgraphic\n\n\n\n\n\n\n\n\n
\n
\n

procgraphic

\n
\n
\n
\n
    \n
\n
\n
\n Search: \n
\n
\n Group by:\n \n
\n \n\n
\n
\n
\n

\n \n
\n

Types

\n
\n\n
ProcGraphic = ref object of Graphic\n  procedure*: proc (graphic: ProcGraphic; pos: Coord; angle: Angle; scale: Scale;\n                  center: Coord; flip: Flip; region: Rect) {...}{.locks: 0.} ## Drawing procedure.\n  dimProcedure*: proc (): Dim {...}{.locks: 0.} ## Dimensions procedure.\n
\n
\n\n\n
\n\n
\n
\n

Procs

\n
\n\n
proc newProcGraphic(): ProcGraphic {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc drawProcGraphic(graphic: ProcGraphic; pos: Coord = (0.0, 0.0); angle: Angle = 0.0;\n                    scale: Scale = 1.0; center: Coord = (0.0, 0.0);\n                    flip: Flip = Flip.none;\n                    region: Rect = Rect(x: 0, y: 0, w: 0, h: 0)) {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
\n
\n

Methods

\n
\n\n
method w(graphic: ProcGraphic): int {...}{.raises: [Exception], tags: [RootEffect].}
\n
\nReturn the width of the graphic if available, or nil otherwise. \n\n
\n\n
method h(graphic: ProcGraphic): int {...}{.raises: [Exception], tags: [RootEffect].}
\n
\nReturn the height of the graphic if available, or nil otherwise. \n\n
\n\n
method dim(graphic: ProcGraphic): Dim {...}{.raises: [Exception], tags: [RootEffect].}
\n
\nReturn the graphic's dimensions if available, or nil otherwise. \n\n
\n\n
method draw(graphic: ProcGraphic; pos: Coord = (0.0, 0.0); angle: Angle = 0.0;\n           scale: Scale = 1.0; center: Coord = (0.0, 0.0); flip: Flip = Flip.none;\n           region: Rect = Rect(x: 0, y: 0, w: 0, h: 0)) {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
\n\n
\n
\n\n
\n
\n \n
\n Made with Nim. Generated: 2019-01-21 14:58:38 UTC\n
\n
\n
\n
\n\n\n\n" }, { "path": "docs/docs/scene.html", "content": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\nscene\n\n\n\n\n\n\n\n\n
\n
\n

scene

\n
\n
\n
\n
    \n
\n
\n
\n Search: \n
\n
\n Group by:\n \n
\n \n\n
\n
\n
\n

\n \n
\n

Types

\n
\n\n
Scene = ref object of RootObj\n  fList, fAddList: seq[Entity]\n  camera*, cameraBond*: Entity  ## Camera and its bond Entity\n  cameraBondOffset*: Coord     ## Camera's offstet from its bond\n
\n
\n\n\n
\n\n
\n
\n

Procs

\n
\n\n
proc init(scene: Scene) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc eventScene(scene: Scene; e: sdl.Event) {...}{.raises: [Exception], tags: [RootEffect].}
\n
\n\n\n
\n\n
proc renderScene(scene: Scene) {...}{.raises: [Exception], tags: [RootEffect].}
\n
\n

Default scene render procedure.

\n

Call it from your scene render method.

\n\n\n
\n\n
proc add(scene: Scene; entity: Entity) {...}{.raises: [], tags: [].}
\n
\nAdd a new entity to the scene. \n\n
\n\n
proc clear(scene: Scene) {...}{.raises: [], tags: [].}
\n
\nRemove all entities from the scene. \n\n
\n\n
proc contains(scene: Scene; entity: Entity): bool {...}{.inline, raises: [], tags: [].}
\n
\nReturn true if the scene has the entity, or false otherwise. \n\n
\n\n
proc contains(scene: Scene; tag: string): bool {...}{.raises: [], tags: [].}
\n
\nReturn true if the scene has an entity with tag, or false otherwise. \n\n
\n\n
proc count(scene: Scene): int {...}{.inline, raises: [], tags: [].}
\n
\nReturn the number of entities in the scene. \n\n
\n\n
proc count(scene: Scene; tag: string): int {...}{.raises: [], tags: [].}
\n
\nReturn the number of entities with tag in the scene. \n\n
\n\n
proc del(scene: Scene; entity: Entity): bool {...}{.raises: [], tags: [].}
\n
\n

Delete entity from the scene.

\n

Return true if entity was deleted, or false if there is no such entity in the scene.

\n\n\n
\n\n
proc del(scene: Scene; tag: string) {...}{.raises: [], tags: [].}
\n
\nDelete all entities with tag from the scene. \n\n
\n\n
proc find(scene: Scene; tag: string): Entity {...}{.raises: [], tags: [].}
\n
\nReturn the first entity with tag in the scene, or nil otherwise. \n\n
\n\n
proc findAll(scene: Scene; tag: string): seq[Entity] {...}{.raises: [], tags: [].}
\n
\nReturn a sequence of all entities with tag in the scene, or an empty sequence if no such entities are found. \n\n
\n\n
proc pop(scene: Scene): Entity {...}{.inline, raises: [], tags: [].}
\n
\nReturn the top entity and remove it from the scene. \n\n
\n\n
proc updateScene(scene: Scene; elapsed: float) {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n

Default scene update procedure.

\n

Call it from your scene update method.

\n\n\n
\n\n
\n
\n

Methods

\n
\n\n
method event(scene: Scene; e: sdl.Event) {...}{.base, raises: [Exception], tags: [RootEffect].}
\n
\n\n\n
\n\n
method show(scene: Scene) {...}{.base, raises: [], tags: [].}
\n
\nCalled when scene is set in Game. \n\n
\n\n
method hide(scene: Scene) {...}{.base, raises: [], tags: [].}
\n
\nCalled when scene is replaced by other one in Game. \n\n
\n\n
method render(scene: Scene) {...}{.base, raises: [Exception], tags: [RootEffect].}
\n
\n\n\n
\n\n
method update(scene: Scene; elapsed: float) {...}{.base, raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
\n
\n

Iterators

\n
\n\n
iterator entities(scene: Scene): Entity {...}{.inline, raises: [], tags: [].}
\n
\nIterate through all entities in the scene. \n\n
\n\n
iterator entities(scene: Scene; tag: string): Entity {...}{.inline, raises: [], tags: [].}
\n
\nIterate throught entities with tag in the scene. \n\n
\n\n
\n
\n

Templates

\n
\n\n
template bindCameraTo(scene: Scene; bond: Entity; offset: Coord)
\n
\nBind the camera to the movement of the specific entity. \n\n
\n\n
\n\n
\n
\n\n
\n
\n \n
\n Made with Nim. Generated: 2019-01-21 14:58:38 UTC\n
\n
\n
\n
\n\n\n\n" }, { "path": "docs/docs/settings.html", "content": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\nsettings\n\n\n\n\n\n\n\n\n
\n
\n

settings

\n
\n
\n
\n
    \n
\n
\n
\n Search: \n
\n
\n Group by:\n \n
\n \n\n
\n
\n
\n

\n
\n

Vars

\n
\n\n
background: sdl.Color
\n
\nScreen clearing color\n\n
\n\n
renderer: sdl.Renderer
\n
\nGame renderer pointer\n\n
\n\n
gameRunning: bool
\n
\nIf false - break main loop\n\n
\n\n
gamePaused: bool
\n
\nIf true - do not update current scene\n\n
\n\n
showInfo: bool
\n
\nShow info panel\n\n
\n\n
fpsLimit: int
\n
\nLimit frames per second to fpsLimit,\nif 0 - no limit\n\n
\n\n
colliderOutline: bool
\n
\nShow collider outlines\n\n
\n\n
colliderOutlineColor: sdl.Color
\n
\nColor of collider outlines\n\n
\n\n
updateInterval: int
\n
\nupdate() is called each updateInterval ms.\n\n
\n\n
\n\n
\n
\n\n
\n
\n \n
\n Made with Nim. Generated: 2019-01-21 14:58:39 UTC\n
\n
\n
\n
\n\n\n\n" }, { "path": "docs/docs/textfield.html", "content": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\ntextfield\n\n\n\n\n\n\n\n\n
\n
\n

textfield

\n
\n
\n
\n
    \n
\n
\n
\n Search: \n
\n
\n Group by:\n \n
\n \n\n
\n
\n
\n

\n \n
\n

Types

\n
\n\n
TextField = ref object of TextGraphic\n  fActive: bool\n  fCursorIndex: int\n  cursor*: string\n  limit*: int\n
\n
\n\n\n
\n\n
\n
\n

Procs

\n
\n\n
proc init(tf: TextField; font: Font) {...}{.raises: [Exception], tags: [RootEffect].}
\n
\n\n\n
\n\n
proc newTextField(font: Font): TextField {...}{.raises: [Exception], tags: [RootEffect].}
\n
\n\n\n
\n\n
proc text(tf: TextField): string {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc text=(tf: TextField; val: string) {...}{.raises: [Exception], tags: [RootEffect].}
\n
\n\n\n
\n\n
proc bs(tf: TextField; index = -1) {...}{.raises: [Exception], tags: [RootEffect].}
\n
\nBackspace text action. \n\n
\n\n
proc del(tf: TextField; index = -1) {...}{.raises: [Exception], tags: [RootEffect].}
\n
\nDelete text action. \n\n
\n\n
proc add(tf: TextField; str: string; index = -1) {...}{.raises: [Exception], tags: [RootEffect].}
\n
\nAdd text action. \n\n
\n\n
proc left(tf: TextField) {...}{.raises: [Exception], tags: [RootEffect].}
\n
\nMove cursor to the left. \n\n
\n\n
proc right(tf: TextField) {...}{.raises: [Exception], tags: [RootEffect].}
\n
\nMove cursor to the right. \n\n
\n\n
proc toFirst(tf: TextField) {...}{.raises: [Exception], tags: [RootEffect].}
\n
\nMove cursor to the beginning. \n\n
\n\n
proc toLast(tf: TextField) {...}{.raises: [Exception], tags: [RootEffect].}
\n
\nMove cursor to the end. \n\n
\n\n
proc activate(tf: TextField) {...}{.raises: [Exception], tags: [RootEffect].}
\n
\nActivate text field. \n\n
\n\n
proc deactivate(tf: TextField) {...}{.raises: [Exception], tags: [RootEffect].}
\n
\nDeactivate text field. \n\n
\n\n
proc draw(tf: TextField; pos: Coord) {...}{.raises: [Exception], tags: [RootEffect].}
\n
\n\n\n
\n\n
\n
\n

Templates

\n
\n\n
template isActive(tf: TextField): bool
\n
\n\n\n
\n\n
template len(tf: TextField): int
\n
\n\n\n
\n\n
\n\n
\n
\n\n
\n
\n \n
\n Made with Nim. Generated: 2019-01-21 14:58:39 UTC\n
\n
\n
\n
\n\n\n\n" }, { "path": "docs/docs/textgraphic.html", "content": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\ntextgraphic\n\n\n\n\n\n\n\n\n
\n
\n

textgraphic

\n
\n
\n
\n
    \n
\n
\n
\n Search: \n
\n
\n Group by:\n \n
\n \n\n
\n
\n
\n

\n \n
\n

Types

\n
\n\n
TextGraphic = ref object of TextureGraphic\n  fLines: seq[string]\n  fAlign: TextAlign\n  fColor: Color\n  fFont: Font\n
\n
\n\n\n
\n\n
\n
\n

Procs

\n
\n\n
proc free(text: TextGraphic) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc init(text: TextGraphic; font: Font) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc newTextGraphic(font: Font = nil): TextGraphic {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc update(text: TextGraphic) {...}{.raises: [Exception], tags: [RootEffect].}
\n
\n\n\n
\n\n
proc align(text: TextGraphic): TextAlign {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc align=(text: TextGraphic; val: TextAlign) {...}{.inline, raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
proc color(text: TextGraphic): Color {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc color=(text: TextGraphic; val: Color) {...}{.inline, raises: [Exception],\n                                        tags: [RootEffect].}
\n
\n\n\n
\n\n
proc font(text: TextGraphic): Font {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc font=(text: TextGraphic; val: Font) {...}{.inline, raises: [Exception],\n                                      tags: [RootEffect].}
\n
\n\n\n
\n\n
proc lines(text: TextGraphic): seq[string] {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc lines=(text: TextGraphic; lines: openArray[string]) {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
proc text(text: TextGraphic): string {...}{.inline, raises: [], tags: [].}
\n
\nReturn lines, joined in one string. \n\n
\n\n
proc setText(text: TextGraphic; val: string; width: int = 0; seps: set[char] = Whitespace) {...}{.\n    raises: [Exception], tags: [RootEffect].}
\n
\nSet the text lines, wrapping each width characters. \n\n
\n\n
\n\n
\n
\n\n
\n
\n \n
\n Made with Nim. Generated: 2019-01-21 14:58:40 UTC\n
\n
\n
\n
\n\n\n\n" }, { "path": "docs/docs/textureatlas.html", "content": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\ntextureatlas\n\n\n\n\n\n\n\n\n
\n
\n

textureatlas

\n
\n
\n
\n
    \n
\n
\n
\n Search: \n
\n
\n Group by:\n \n
\n \n\n
\n
\n
\n

\n \n
\n

Types

\n
\n\n
TextureAtlas = OrderedTableRef[string, TextureGraphic]
\n
\n\n\n
\n\n
\n
\n

Procs

\n
\n\n
proc free(atlas: TextureAtlas) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc newTextureAtlas(imagefile, mapfile: string; count: int = 64): TextureAtlas {...}{.\n    raises: [CsvError, Exception, OverflowError, ValueError],\n    tags: [ReadIOEffect, RootEffect].}
\n
\n

Create a new TextureAtlas.

\n

imagefile file containging the image atlas.

\n

mapfile CSV file containing atlas mapping in a format of:

\n

name, x, y, w, h ...

\n

count expected mappings count.

\n\n\n
\n\n
proc newTextureAtlas(imageSrc, mapSrc: ptr RWops; count: int = 64;\n                    freeImageSrc: bool = true; freeMapSrc: bool = true): TextureAtlas {...}{.\n    raises: [Exception, CsvError, OverflowError, ValueError],\n    tags: [RootEffect, ReadIOEffect].}
\n
\n\n\n
\n\n
\n\n
\n
\n\n
\n
\n \n
\n Made with Nim. Generated: 2019-01-21 14:58:40 UTC\n
\n
\n
\n
\n\n\n\n" }, { "path": "docs/docs/texturegraphic.html", "content": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\ntexturegraphic\n\n\n\n\n\n\n\n\n
\n
\n

texturegraphic

\n
\n
\n
\n
    \n
\n
\n
\n Search: \n
\n
\n Group by:\n \n
\n \n\n
\n
\n
\n

\n \n
\n

Types

\n
\n\n
TextureGraphic = ref object of Graphic\n  fTexture: sdl.Texture\n  fFormat: uint32\n  fSize: Dim\n
\n
\n\n\n
\n\n
\n
\n

Procs

\n
\n\n
proc freeTexture(graphic: TextureGraphic) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc free(graphic: TextureGraphic) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc init(graphic: TextureGraphic) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc updateTexture(graphic: TextureGraphic): bool {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
proc format(graphic: TextureGraphic): uint32 {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc load(graphic: TextureGraphic; file: string): bool {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n

Load texture from file.

\n

Return true on success, false otherwise.

\n\n\n
\n\n
proc load(graphic: TextureGraphic; rw: ptr RWops; freeSrc: bool = true): bool {...}{.\n    raises: [Exception], tags: [RootEffect].}
\n
\n

Load texture from src RWops.

\n

Return true on success, false otherwise.

\n\n\n
\n\n
proc assignTexture(graphic: TextureGraphic; texture: Texture;\n                  freeCurrent: bool = true): bool {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n

Assign already created texture.

\n

freeCurrent Free the currently assigned texture. Set to false if it used by other objects.

\n

ATTENTION! The texture will be destroyed on free().

\n

Return true on success, false otherwise.

\n\n\n
\n\n
proc texture(graphic: TextureGraphic): sdl.Texture {...}{.inline, raises: [], tags: [].}
\n
\nDirect access to the graphic's texture. Be careful. \n\n
\n\n
proc newTextureGraphic(): TextureGraphic {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc newTextureGraphic(file: string): TextureGraphic {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
proc newTextureGraphic(src: ptr RWops; freeSrc: bool = true): TextureGraphic {...}{.\n    raises: [Exception], tags: [RootEffect].}
\n
\n\n\n
\n\n
proc newTextureGraphic(texture: Texture): TextureGraphic {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
proc drawTextureGraphic(graphic: TextureGraphic; pos: Coord = (0.0, 0.0);\n                       angle: Angle = 0.0; scale: Scale = 1.0;\n                       center: Coord = (0.0, 0.0); flip: Flip = Flip.none;\n                       region: Rect = Rect(x: 0, y: 0, w: 0, h: 0)) {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n

Draw procedure.

\n

pos Draw coordinates.

\n

angle Rotation angle in degrees.

\n

scale Draw scale. 1.0 for original size.

\n

center Center of rendering, rotation, and scaling.

\n

flip RendererFlip value, could be set to: FlipNone, FlipHorizontal, FlipVertical.

\n

region Source texture region to draw.

\n\n\n
\n\n
proc drawTiled(graphic: TextureGraphic; rect: Rect;\n              region: Rect = Rect(x: 0, y: 0, w: 0, h: 0); reverseX = false; reverseY = false) {...}{.\n    raises: [Exception], tags: [RootEffect].}
\n
\n

Repeatedly draw the graphic to fill the rect.

\n

region Source texture region to draw.

\n

reverseX, reverseY Drawing progression order.

\n\n\n
\n\n
proc colorMod(graphic: TextureGraphic): Color {...}{.raises: [], tags: [].}
\n
\nReturn current color modifier. \n\n
\n\n
proc colorMod=(graphic: TextureGraphic; color: Color) {...}{.raises: [], tags: [].}
\n
\nSet a new color modifier. \n\n
\n\n
proc alphaMod(graphic: TextureGraphic): uint8 {...}{.raises: [], tags: [].}
\n
\nReturn current alpha (transparency) modifier. \n\n
\n\n
proc alphaMod=(graphic: TextureGraphic; alpha: uint8) {...}{.raises: [], tags: [].}
\n
\nSet a new alpha (transparency) modifier. \n\n
\n\n
proc blendMod(graphic: TextureGraphic): Blend {...}{.raises: [], tags: [].}
\n
\nReturn current blending mode. \n\n
\n\n
proc blendMod=(graphic: TextureGraphic; blend: Blend) {...}{.raises: [], tags: [].}
\n
\nSet a new blending mode. \n\n
\n\n
\n
\n

Methods

\n
\n\n
method w(graphic: TextureGraphic): int {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
method h(graphic: TextureGraphic): int {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
method dim(graphic: TextureGraphic): Dim {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
method draw(graphic: TextureGraphic; pos: Coord = (0.0, 0.0); angle: Angle = 0.0;\n           scale: Scale = 1.0; center: Coord = (0.0, 0.0); flip: Flip = Flip.none;\n           region: Rect = Rect(x: 0, y: 0, w: 0, h: 0)) {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
\n\n
\n
\n\n
\n
\n \n
\n Made with Nim. Generated: 2019-01-21 14:58:41 UTC\n
\n
\n
\n
\n\n\n\n" }, { "path": "docs/docs/tilemap.html", "content": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\ntilemap\n\n\n\n\n\n\n\n\n
\n
\n

tilemap

\n
\n
\n
\n
    \n
\n
\n
\n Search: \n
\n
\n Group by:\n \n
\n \n\n
\n
\n
\n

\n \n
\n

Types

\n
\n\n
TileShow = tuple[x: Slice[int], y: Slice[int]]
\n
\n\n\n
\n\n
TileMap = ref object of Entity\n  map*: seq[seq[int]]          ## Two-dimensional sequence of tile indexes (y, x)\n  fShow: TileShow              ## Slice of what part of map to show\n  hidden*: seq[int]            ## The list of tile indexes to not render\n  passable*: seq[int]          ## The list of tile indexes without colliders\n  onlyReachableColliders*: bool ## Do not create colliders \\\n                              ## for unreachable tiles\n  tileScale*: Scale ## \\\n                  ## The scaling of individual tiles, mostly used for gap removal. \\\n                  ## Increase on scales vastly different from `1.0`. \\\n                  ## Set to `1.0` if your map isn't rotating or scaling.\n
\n
\n\n\n
\n\n
TileCollider = ref object of BoxCollider\n  value*: int                  ## Tile kind value\n  index*: CoordInt             ## Map coordinates\n
\n
\n\n\n
\n\n
TileMapCollider = ref object of Collider\n  map: TileMap\n  tiles: seq[seq[TileCollider]] ## Two-dimensional sequence of colliders \\\n                              ## (y, x)\n
\n
\nCollider to use with TileMap\n\n
\n\n
\n
\n

Consts

\n
\n\n
DefaultTileScale: Scale = 1.02
\n
\n\n\n
\n\n
\n
\n

Procs

\n
\n\n
proc init(tilemap: TileMap; scaleFix = false) {...}{.raises: [], tags: [].}
\n
\n

TileMap initialization.

\n

scaleFix set tileScale to DefaultTileScale if true, or to 1.0 otherwise.

\n\n\n
\n\n
proc newTileMap(scaleFix = false): TileMap {...}{.raises: [], tags: [].}
\n
\n

Create a new TileMap.

\n

scaleFix set tileScale to DefaultTileScale if true, or to 1.0 otherwise.

\n\n\n
\n\n
proc show(tilemap: TileMap): TileShow {...}{.inline, raises: [], tags: [].}
\n
\nReturn a currently shown slices of tiles. \n\n
\n\n
proc show=(tilemap: TileMap; val: TileShow) {...}{.raises: [], tags: [].}
\n
\nSet new values for the shown slices of tiles. \n\n
\n\n
proc dimTiles(tilemap: TileMap): Dim {...}{.raises: [], tags: [].}
\n
\nReturn dimensions of the tilemap, calculated from its map (in tiles). \n\n
\n\n
proc dim(tilemap: TileMap): Dim {...}{.inline, raises: [], tags: [].}
\n
\nReturn dimensions of the tilemap, calculated from its map (in pixels). \n\n
\n\n
proc centrify(tilemap: TileMap; hor = HAlign.center; ver = VAlign.center) {...}{.raises: [],\n    tags: [].}
\n
\n

Set tilemap's center, according to the given align.

\n

hor Horisontal align: left, center, or right

\n

ver Vertical align: top, center, or bottom

\n\n\n
\n\n
proc firstTileIndex(tilemap: TileMap; value: int): CoordInt {...}{.raises: [], tags: [].}
\n
\nReturn the first tile index with a specific value. \n\n
\n\n
proc tileIndex(tilemap: TileMap; pos: Coord): CoordInt {...}{.raises: [], tags: [].}
\n
\nReturn the tile map index of a tile that is located at the given screen position. \n\n
\n\n
proc tilePos(tilemap: TileMap; index: CoordInt): Coord {...}{.raises: [], tags: [].}
\n
\nReturn screen position of a tile with the given tile map index. \n\n
\n\n
proc renderTileMap(tilemap: TileMap) {...}{.raises: [Exception], tags: [RootEffect].}
\n
\n\n\n
\n\n
proc init(t: TileCollider; parent: TileMap; pos: Coord = (0, 0); dim: Dim = (0, 0); value: int;\n         index: CoordInt) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc newTileCollider(parent: TileMap; pos: Coord = (0, 0); dim: Dim = (0, 0); value: int;\n                    index: CoordInt): TileCollider {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc init(t: TileMapCollider; parent: TileMap; pos: Coord = (0, 0); dim: Dim = (0, 0)) {...}{.\n    raises: [], tags: [].}
\n
\n\n\n
\n\n
proc newTileMapCollider(parent: TileMap; pos: Coord = (0, 0); dim: Dim = (0, 0)): TileMapCollider {...}{.\n    raises: [], tags: [].}
\n
\n

Create a TileMapCollider for the parent TileMap.

\n

Most of the times you should use initCollider() instead.

\n

pos Collider's relative position. Usually (0, 0).

\n

dim Tile dimensions.

\n\n\n
\n\n
proc initCollider(tilemap: TileMap) {...}{.raises: [], tags: [].}
\n
\nInitialize a collider for the tilemap. \n\n
\n\n
\n
\n

Methods

\n
\n\n
method render(tilemap: TileMap) {...}{.raises: [Exception], tags: [RootEffect].}
\n
\n\n\n
\n\n
method render(t: TileMapCollider) {...}{.raises: [Exception], tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(t: TileMapCollider; pos: Coord): bool {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(t: TileMapCollider; a: Collider): bool {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(a: Collider; t: TileMapCollider): bool {...}{.inline, raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(t: TileMapCollider; b: BoxCollider): bool {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(b: BoxCollider; t: TileMapCollider): bool {...}{.inline, raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(t: TileMapCollider; c: CircleCollider): bool {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(c: CircleCollider; t: TileMapCollider): bool {...}{.inline,\n    raises: [Exception], tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(t: TileMapCollider; d: LineCollider): bool {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(d: LineCollider; t: TileMapCollider): bool {...}{.inline,\n    raises: [Exception], tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(t: TileMapCollider; p: PolyCollider): bool {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(p: PolyCollider; t: TileMapCollider): bool {...}{.inline,\n    raises: [Exception], tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(t: TileMapCollider; g: GroupCollider): bool {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(g: GroupCollider; t: TileMapCollider): bool {...}{.inline,\n    raises: [Exception], tags: [RootEffect].}
\n
\n\n\n
\n\n
method collide(t1, t2: TileMapCollider): bool {...}{.raises: [Exception], tags: [RootEffect].}
\n
\n\n\n
\n\n
\n
\n

Iterators

\n
\n\n
iterator tileIndex(tilemap: TileMap; value: int): CoordInt {...}{.raises: [], tags: [].}
\n
\nIterate through tiles with a specific value. \n\n
\n\n
iterator tileColliders(t: TileMapCollider): TileCollider {...}{.raises: [], tags: [].}
\n
\nIterate through all tile colliders of t TilemapCollider. \n\n
\n\n
\n
\n

Templates

\n
\n\n
template tile(tilemap: TileMap; index: CoordInt): var int
\n
\nDirect access to a single tile value. \n\n
\n\n
template collisionList(t: TileMapCollider; a: typed; first: bool = false): seq[\n    TileCollider]
\n
\n

Get a list of collided TileColliders.

\n

a collision target (Coord, any Collider, etc.)

\n

first If true, return after the first detected collision.

\n\n\n
\n\n
\n\n
\n
\n\n
\n
\n \n
\n Made with Nim. Generated: 2019-01-21 14:58:41 UTC\n
\n
\n
\n
\n\n\n\n" }, { "path": "docs/docs/truetypefont.html", "content": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\ntruetypefont\n\n\n\n\n\n\n\n\n
\n
\n

truetypefont

\n
\n
\n
\n
    \n
\n
\n
\n Search: \n
\n
\n Group by:\n \n
\n \n\n
\n
\n
\n

\n \n
\n

Types

\n
\n\n
TrueTypeFont = ref object of font.Font\n  fFont: ttf.Font\n
\n
\n\n\n
\n\n
\n
\n

Procs

\n
\n\n
proc free(font: TrueTypeFont) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc init(font: TrueTypeFont) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc newTrueTypeFont(): TrueTypeFont {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc load(font: TrueTypeFont; file: string; size: int): bool {...}{.raises: [], tags: [].}
\n
\n

Load font data from a file.

\n

size required font size.

\n\n\n
\n\n
proc load(font: TrueTypeFont; src: ptr RWops; size: int; freeSrc: bool = true): bool {...}{.\n    raises: [], tags: [].}
\n
\n

Load font data from a src RWops.

\n

size required font size.

\n\n\n
\n\n
proc renderTrueTypeFont(font: TrueTypeFont; line: string;\n                       color: Color = DefaultFontColor): Surface {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
\n
\n

Methods

\n
\n\n
method getError(font: TrueTypeFont): string {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
method charH(font: TrueTypeFont): int {...}{.raises: [], tags: [].}
\n
\nReturn a font character's height. \n\n
\n\n
method lineDim(font: TrueTypeFont; line: string): Dim {...}{.raises: [], tags: [].}
\n
\nReturn dimensions of a line of text, written in font. \n\n
\n\n
method render(font: TrueTypeFont; line: string; color: Color = DefaultFontColor): Surface {...}{.\n    raises: [], tags: [].}
\n
\n\n\n
\n\n
\n\n
\n
\n\n
\n
\n \n
\n Made with Nim. Generated: 2019-01-21 14:58:42 UTC\n
\n
\n
\n
\n\n\n\n" }, { "path": "docs/docs/tween.html", "content": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\ntween\n\n\n\n\n\n\n\n\n
\n
\n

tween

\n
\n
\n
\n
    \n
\n
\n
\n Search: \n
\n
\n Group by:\n \n
\n \n\n
\n
\n
\n

\n
\n

Types

\n
\n\n
TweenProcedure[V] = proc (start, distance: V; elapsed, duration: float;\n                       amplitude, period: V; back: float): V
\n
\n\n\n
\n\n
TweenEnder[T; V] = proc (tween: Tween[T, V])
\n
\n\n\n
\n\n
Tween[T; V] = ref object of RootObj\n  target: T                    ## Target object\n  get: proc (e: T): V             ## A value getter procedure\n  set: proc (e: T; v: V)           ## A value setter procedure\n  fStart, fFinish: V            ## Starting and finishing values\n  fDistance: V                 ## Total distance (finish - start)\n  fElapsed, fDuration: float    ## Elapsed and total duration (in seconds)\n  amplitude*, period*: V        ## Ease elastic amplitude and period\n  back*: float                 ## Ease Back coefficient\n  loop*, loopLimit*: int        ## Loop counter and loop limit\n  playing*: bool               ## Playing status flag\n  procedure*: TweenProcedure[V] ## \\\n                              ## Value changing procedure, called from the ``update()``\n  ender*: TweenEnder[T, V]      ## \\\n                        ##  Loop ending procedure, called from the ``update()``\n
\n
\n\n\n
\n\n
\n
\n

Procs

\n
\n\n
proc value[T, V](tween: Tween[T, V]): V {...}{.inline.}
\n
\nReturn the target value of tween. \n\n
\n\n
proc value=[T, V](tween: Tween[T, V]; val: V) {...}{.inline.}
\n
\nSet the target value of tween to val. \n\n
\n\n
proc start[T, V](tween: Tween[T, V]): V {...}{.inline.}
\n
\nReturn starting value. \n\n
\n\n
proc finish[T, V](tween: Tween[T, V]): V {...}{.inline.}
\n
\nReturn final value. \n\n
\n\n
proc distance[T, V](tween: Tween[T, V]): V {...}{.inline.}
\n
\nReturn the total distance. \n\n
\n\n
proc duration(tween: Tween): float {...}{.inline.}
\n
\nReturn tween's total duration. \n\n
\n\n
proc elapsed(tween: Tween): float {...}{.inline.}
\n
\nReturn tween's elapsed duration. \n\n
\n\n
proc progress(tween: Tween): float
\n
\nReturn tween progress in 0.0..`1.0` range. \n\n
\n\n
proc play(tween: Tween)
\n
\nStart playing tween with previously set params. \n\n
\n\n
proc stop(tween: Tween)
\n
\nStop playing tween immediately. \n\n
\n\n
proc setup[T, V](tween: Tween[T, V]; start, finish: V; duration: float; loops = 0)
\n
\n

Set up tween params.

\n

start, finish Limiting values for the target variable.

\n

duration Duration (in seconds).

\n

loops Loop limit. 0 for one loop, -1 for looping forever.

\n\n\n
\n\n
proc update(tween: Tween; elapsed: float)
\n
\nTween update procedure. Call it from the scene update method. \n\n
\n\n
proc linear[V](start, distance: V; elapsed, duration: float; amplitude, period: V;\n              back: float): V {...}{.procvar.}
\n
\nLinear tween procedure. \n\n
\n\n
proc inQuad[V](start, distance: V; elapsed, duration: float; amplitude, period: V;\n              back: float): V {...}{.procvar.}
\n
\nEase In Quadratic tween procedure. \n\n
\n\n
proc outQuad[V](start, distance: V; elapsed, duration: float; amplitude, period: V;\n               back: float): V {...}{.procvar.}
\n
\nEase Out Quadratic tween procedure. \n\n
\n\n
proc inOutQuad[V](start, distance: V; elapsed, duration: float; amplitude, period: V;\n                 back: float): V {...}{.procvar.}
\n
\nEase In/Out Quadratic tween procedure. \n\n
\n\n
proc inCubic[V](start, distance: V; elapsed, duration: float; amplitude, period: V;\n               back: float): V {...}{.procvar.}
\n
\nEase In Cubic tween procedure. \n\n
\n\n
proc outCubic[V](start, distance: V; elapsed, duration: float; amplitude, period: V;\n                back: float): V {...}{.procvar.}
\n
\nEase Out Cubic tween procedure. \n\n
\n\n
proc inOutCubic[V](start, distance: V; elapsed, duration: float; amplitude, period: V;\n                  back: float): V {...}{.procvar.}
\n
\nEase In/Out Cubic tween procedure. \n\n
\n\n
proc outInCubic[V](start, distance: V; elapsed, duration: float; amplitude, period: V;\n                  back: float): V {...}{.procvar.}
\n
\nEase Out/In Cubic tween procedure. \n\n
\n\n
proc inQuart[V](start, distance: V; elapsed, duration: float; amplitude, period: V;\n               back: float): V {...}{.procvar.}
\n
\nEase In Quart tween procedure. \n\n
\n\n
proc outQuart[V](start, distance: V; elapsed, duration: float; amplitude, period: V;\n                back: float): V {...}{.procvar.}
\n
\nEase Out Quart tween procedure. \n\n
\n\n
proc inOutQuart[V](start, distance: V; elapsed, duration: float; amplitude, period: V;\n                  back: float): V {...}{.procvar.}
\n
\nEase In/Out Quart tween procedure. \n\n
\n\n
proc outInQuart[V](start, distance: V; elapsed, duration: float; amplitude, period: V;\n                  back: float): V {...}{.procvar.}
\n
\nEase Out/In Quart tween procedure \n\n
\n\n
proc inQuint[V](start, distance: V; elapsed, duration: float; amplitude, period: V;\n               back: float): V {...}{.procvar.}
\n
\nEase In Quint tween procedure. \n\n
\n\n
proc outQuint[V](start, distance: V; elapsed, duration: float; amplitude, period: V;\n                back: float): V {...}{.procvar.}
\n
\nEase Out Quint tween procedure. \n\n
\n\n
proc inOutQuint[V](start, distance: V; elapsed, duration: float; amplitude, period: V;\n                  back: float): V {...}{.procvar.}
\n
\nEase In/Out Quint tween procedure. \n\n
\n\n
proc outInQuint[V](start, distance: V; elapsed, duration: float; amplitude, period: V;\n                  back: float): V {...}{.procvar.}
\n
\nEase Out/In Quint tween procedure. \n\n
\n\n
proc inSine[V](start, distance: V; elapsed, duration: float; amplitude, period: V;\n              back: float): V {...}{.procvar.}
\n
\nEase In Sine tween procedure. \n\n
\n\n
proc outSine[V](start, distance: V; elapsed, duration: float; amplitude, period: V;\n               back: float): V {...}{.procvar.}
\n
\nEase Out Sine tween procedure. \n\n
\n\n
proc inOutSine[V](start, distance: V; elapsed, duration: float; amplitude, period: V;\n                 back: float): V {...}{.procvar.}
\n
\nEase In/Out Sine tween procedure. \n\n
\n\n
proc outInSine[V](start, distance: V; elapsed, duration: float; amplitude, period: V;\n                 back: float): V {...}{.procvar.}
\n
\nEase Out/In Sine tween procedure. \n\n
\n\n
proc inExpo[V](start, distance: V; elapsed, duration: float; amplitude, period: V;\n              back: float): V {...}{.procvar.}
\n
\nEase In Expo tween procedure. \n\n
\n\n
proc outExpo[V](start, distance: V; elapsed, duration: float; amplitude, period: V;\n               back: float): V {...}{.procvar.}
\n
\nEase Out Expo tween procedure. \n\n
\n\n
proc inOutExpo[V](start, distance: V; elapsed, duration: float; amplitude, period: V;\n                 back: float): V {...}{.procvar.}
\n
\nEase In/Out Expo tween procedure. \n\n
\n\n
proc outInExpo[V](start, distance: V; elapsed, duration: float; amplitude, period: V;\n                 back: float): V {...}{.procvar.}
\n
\nEase Out/In Expo tween procedure. \n\n
\n\n
proc inCirc[V](start, distance: V; elapsed, duration: float; amplitude, period: V;\n              back: float): V {...}{.procvar.}
\n
\nEase In Circ tween procedure. \n\n
\n\n
proc outCirc[V](start, distance: V; elapsed, duration: float; amplitude, period: V;\n               back: float): V {...}{.procvar.}
\n
\nEase Out Circ tween procedure. \n\n
\n\n
proc inOutCirc[V](start, distance: V; elapsed, duration: float; amplitude, period: V;\n                 back: float): V {...}{.procvar.}
\n
\nEase In/Out Circ tween procedure. \n\n
\n\n
proc outInCirc[V](start, distance: V; elapsed, duration: float; amplitude, period: V;\n                 back: float): V {...}{.procvar.}
\n
\nEase Out/In Circ tween procedure. \n\n
\n\n
proc outBounce[V](start, distance: V; elapsed, duration: float; amplitude, period: V;\n                 back: float): V {...}{.procvar.}
\n
\nEase Out Bounce tween procedure. \n\n
\n\n
proc inBounce[V](start, distance: V; elapsed, duration: float; amplitude, period: V;\n                back: float): V {...}{.procvar.}
\n
\nEase In Bounce tween procedure. \n\n
\n\n
proc inOutBounce[V](start, distance: V; elapsed, duration: float; amplitude, period: V;\n                   back: float): V {...}{.procvar.}
\n
\nEase In/Out Bounce tween procedure. \n\n
\n\n
proc outInBounce[V](start, distance: V; elapsed, duration: float; amplitude, period: V;\n                   back: float): V {...}{.procvar.}
\n
\nEase Out/In Bounce tween procedure. \n\n
\n\n
proc inElastic[V](start, distance: V; elapsed, duration: float; amplitude, period: V;\n                 back: float): V {...}{.procvar.}
\n
\nEase In Elastic tween procedure. \n\n
\n\n
proc outElastic[V](start, distance: V; elapsed, duration: float; amplitude, period: V;\n                  back: float): V {...}{.procvar.}
\n
\nEase Out Elastic tween procedure. \n\n
\n\n
proc inOutElastic[V](start, distance: V; elapsed, duration: float;\n                    amplitude, period: V; back: float): V {...}{.procvar.}
\n
\nEase In/Out Elastic tween procedure. \n\n
\n\n
proc outInElastic[V](start, distance: V; elapsed, duration: float;\n                    amplitude, period: V; back: float): V {...}{.procvar.}
\n
\nEase Out/In Elastic tween procedure. \n\n
\n\n
proc inBack[V](start, distance: V; elapsed, duration: float; amplitude, period: V;\n              back: float): V {...}{.procvar.}
\n
\nEase In Back tween procedure. \n\n
\n\n
proc outBack[V](start, distance: V; elapsed, duration: float; amplitude, period: V;\n               back: float): V {...}{.procvar.}
\n
\nEase Out Back tween procedure. \n\n
\n\n
proc inOutBack[V](start, distance: V; elapsed, duration: float; amplitude, period: V;\n                 back: float): V {...}{.procvar.}
\n
\nEase In/Out Back tween procedure. \n\n
\n\n
proc outInBack[V](start, distance: V; elapsed, duration: float; amplitude, period: V;\n                 back: float): V {...}{.procvar.}
\n
\nEase Out/In Back tween procedure. \n\n
\n\n
proc reversing(tween: Tween) {...}{.procvar.}
\n
\n

Tween ender.

\n

Reverses the direction on each loop.

\n

Default option.

\n

Note: each reversal counts as one loop.

\n\n\n
\n\n
proc repeating(tween: Tween) {...}{.procvar.}
\n
\n

Tween ender.

\n

Repeats from start to finish on each loop.

\n\n\n
\n\n
proc init[T, V](tween: Tween[T, V]; target: T; get: proc (e: T): V; set: proc (e: T; v: V))
\n
\n

Set new bindings for the tween.

\n

target The target object of this tween.

\n

get A value getter procedure.

\n

set A value setter procedure.

\n\n\n
\n\n
proc newTween[T, V](target: T; get: proc (e: T): V; set: proc (e: T; v: V)): Tween[T, V]
\n
\n

Create a new Tween.

\n

target The target object of this tween.

\n

get A value getter procedure.

\n

set A value setter procedure.

\n\n\n
\n\n
\n\n
\n
\n\n
\n
\n \n
\n Made with Nim. Generated: 2019-01-21 14:58:42 UTC\n
\n
\n
\n
\n\n\n\n" }, { "path": "docs/docs/types.html", "content": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\ntypes\n\n\n\n\n\n\n\n\n
\n
\n

types

\n
\n
\n
\n
    \n
\n
\n
\n Search: \n
\n
\n Group by:\n \n
\n \n\n
\n
\n
\n \n

\n
\n

Imports

\n
\nutils\n
\n
\n

Types

\n
\n\n
Coord = tuple[x: float, y: float]
\n
\n\nCoordinates type\n\n
\n\n
Coord2 = tuple[abs, rel: Coord]
\n
\n\nAbs + Rel coordinates type\n\n
\n\n
CoordInt = tuple[x: int, y: int]
\n
\n\nInteger coordinates\n\n
\n\n
Dim = tuple[w: int, h: int]
\n
\n\nDimensions type\n\n
\n\n
Angle = float
\n
\n\nAngle type\n\n
\n\n
Scale = float
\n
\n\nScale type\n\n
\n\n
Transform = tuple[pos: Coord, angle: Angle, scale: Scale]
\n
\n\n\n\n
\n\n
Blend {...}{.size: 4, pure.} = enum\n  none = sdl.BlendModeNone, blend = sdl.BlendModeBlend, bAdd = sdl.BlendModeAdd,\n  bMod = sdl.BlendModeMod
\n
\n\n\n\n
\n\n
Flip {...}{.size: 4, pure.} = enum\n  none = sdl.FlipNone, horizontal = sdl.FlipHorizontal, vertical = sdl.FlipVertical,\n  both = sdl.FlipBoth
\n
\n\n\n\n
\n\n
TextAlign {...}{.pure.} = enum\n  left, center, right
\n
\n\n\n\n
\n\n
Direction {...}{.pure.} = enum\n  leftRight, rightLeft, topBottom, bottomTop
\n
\n\n\n\n
\n\n
HAlign {...}{.pure.} = enum\n  left, center, right
\n
\n\n\n\n
\n\n
VAlign {...}{.pure.} = enum\n  top, center, bottom
\n
\n\n\n\n
\n\n
\n
\n

Consts

\n
\n\n
ColorBlack = 255
\n
\n\n\n\n
\n\n
ColourBlack = 255
\n
\n\n\n\n
\n\n
ColorNavy = 33023
\n
\n\n\n\n
\n\n
ColourNavy = 33023
\n
\n\n\n\n
\n\n
ColorDarkBlue = 35839
\n
\n\n\n\n
\n\n
ColourDarkBlue = 35839
\n
\n\n\n\n
\n\n
ColorMediumBlue = 52735
\n
\n\n\n\n
\n\n
ColourMediumBlue = 52735
\n
\n\n\n\n
\n\n
ColorBlue = 65535
\n
\n\n\n\n
\n\n
ColourBlue = 65535
\n
\n\n\n\n
\n\n
ColorDarkGreen = 6553855
\n
\n\n\n\n
\n\n
ColourDarkGreen = 6553855
\n
\n\n\n\n
\n\n
ColorGreen = 8388863
\n
\n\n\n\n
\n\n
ColourGreen = 8388863
\n
\n\n\n\n
\n\n
ColorTeal = 8421631
\n
\n\n\n\n
\n\n
ColourTeal = 8421631
\n
\n\n\n\n
\n\n
ColorDarkCyan = 9145343
\n
\n\n\n\n
\n\n
ColourDarkCyan = 9145343
\n
\n\n\n\n
\n\n
ColorDeepSkyBlue = 12582911
\n
\n\n\n\n
\n\n
ColourDeepSkyBlue = 12582911
\n
\n\n\n\n
\n\n
ColorDarkTurquoise = 13554175
\n
\n\n\n\n
\n\n
ColourDarkTurquoise = 13554175
\n
\n\n\n\n
\n\n
ColorMediumSpringGreen = 16423679
\n
\n\n\n\n
\n\n
ColourMediumSpringGreen = 16423679
\n
\n\n\n\n
\n\n
ColorLime = 16711935
\n
\n\n\n\n
\n\n
ColourLime = 16711935
\n
\n\n\n\n
\n\n
ColorSpringGreen = 16744447
\n
\n\n\n\n
\n\n
ColourSpringGreen = 16744447
\n
\n\n\n\n
\n\n
ColorAqua = 16777215
\n
\n\n\n\n
\n\n
ColourAqua = 16777215
\n
\n\n\n\n
\n\n
ColorCyan = 16777215
\n
\n\n\n\n
\n\n
ColourCyan = 16777215
\n
\n\n\n\n
\n\n
ColorMidnightBlue = 421097727
\n
\n\n\n\n
\n\n
ColourMidnightBlue = 421097727
\n
\n\n\n\n
\n\n
ColorDodgerBlue = 512819199
\n
\n\n\n\n
\n\n
ColourDodgerBlue = 512819199
\n
\n\n\n\n
\n\n
ColorLightSeaGreen = 548580095
\n
\n\n\n\n
\n\n
ColourLightSeaGreen = 548580095
\n
\n\n\n\n
\n\n
ColorForestGreen = 579543807
\n
\n\n\n\n
\n\n
ColourForestGreen = 579543807
\n
\n\n\n\n
\n\n
ColorSeaGreen = 780883967
\n
\n\n\n\n
\n\n
ColourSeaGreen = 780883967
\n
\n\n\n\n
\n\n
ColorDarkSlateGray = 793726975
\n
\n\n\n\n
\n\n
ColourDarkSlateGray = 793726975
\n
\n\n\n\n
\n\n
ColorDarkSlateGrey = 793726975
\n
\n\n\n\n
\n\n
ColourDarkSlateGrey = 793726975
\n
\n\n\n\n
\n\n
ColorLimeGreen = 852308735
\n
\n\n\n\n
\n\n
ColourLimeGreen = 852308735
\n
\n\n\n\n
\n\n
ColorMediumSeaGreen = 1018393087
\n
\n\n\n\n
\n\n
ColourMediumSeaGreen = 1018393087
\n
\n\n\n\n
\n\n
ColorTurquoise = 1088475391
\n
\n\n\n\n
\n\n
ColourTurquoise = 1088475391
\n
\n\n\n\n
\n\n
ColorRoyalBlue = 1097458175
\n
\n\n\n\n
\n\n
ColourRoyalBlue = 1097458175
\n
\n\n\n\n
\n\n
ColorSteelBlue = 1182971135
\n
\n\n\n\n
\n\n
ColourSteelBlue = 1182971135
\n
\n\n\n\n
\n\n
ColorDarkSlateBlue = 1211993087
\n
\n\n\n\n
\n\n
ColourDarkSlateBlue = 1211993087
\n
\n\n\n\n
\n\n
ColorMediumTurquoise = 1221709055
\n
\n\n\n\n
\n\n
ColourMediumTurquoise = 1221709055
\n
\n\n\n\n
\n\n
ColorIndigo = 1258324735
\n
\n\n\n\n
\n\n
ColourIndigo = 1258324735
\n
\n\n\n\n
\n\n
ColorDarkOliveGreen = 1433087999
\n
\n\n\n\n
\n\n
ColourDarkOliveGreen = 1433087999
\n
\n\n\n\n
\n\n
ColorCadetBlue = 1604231423
\n
\n\n\n\n
\n\n
ColourCadetBlue = 1604231423
\n
\n\n\n\n
\n\n
ColorCornflowerBlue = 1687547391
\n
\n\n\n\n
\n\n
ColourCornflowerBlue = 1687547391
\n
\n\n\n\n
\n\n
ColorRebeccaPurple = 1714657791
\n
\n\n\n\n
\n\n
ColourRebeccaPurple = 1714657791
\n
\n\n\n\n
\n\n
ColorMediumAquaMarine = 1724754687
\n
\n\n\n\n
\n\n
ColourMediumAquaMarine = 1724754687
\n
\n\n\n\n
\n\n
ColorDimGray = 1768516095
\n
\n\n\n\n
\n\n
ColourDimGray = 1768516095
\n
\n\n\n\n
\n\n
ColorDimGrey = 1768516095
\n
\n\n\n\n
\n\n
ColourDimGrey = 1768516095
\n
\n\n\n\n
\n\n
ColorSlateBlue = 1784335871
\n
\n\n\n\n
\n\n
ColourSlateBlue = 1784335871
\n
\n\n\n\n
\n\n
ColorOliveDrab = 1804477439
\n
\n\n\n\n
\n\n
ColourOliveDrab = 1804477439
\n
\n\n\n\n
\n\n
ColorSlateGray = 1887473919
\n
\n\n\n\n
\n\n
ColourSlateGray = 1887473919
\n
\n\n\n\n
\n\n
ColorSlateGrey = 1887473919
\n
\n\n\n\n
\n\n
ColourSlateGrey = 1887473919
\n
\n\n\n\n
\n\n
ColorLightSlateGray = 2005441023
\n
\n\n\n\n
\n\n
ColourLightSlateGray = 2005441023
\n
\n\n\n\n
\n\n
ColorLightSlateGrey = 2005441023
\n
\n\n\n\n
\n\n
ColourLightSlateGrey = 2005441023
\n
\n\n\n\n
\n\n
ColorMediumSlateBlue = 2070474495
\n
\n\n\n\n
\n\n
ColourMediumSlateBlue = 2070474495
\n
\n\n\n\n
\n\n
ColorLawnGreen = 2096890111
\n
\n\n\n\n
\n\n
ColourLawnGreen = 2096890111
\n
\n\n\n\n
\n\n
ColorChartreuse = 2147418367
\n
\n\n\n\n
\n\n
ColourChartreuse = 2147418367
\n
\n\n\n\n
\n\n
ColorAquamarine = 2147472639
\n
\n\n\n\n
\n\n
ColourAquamarine = 2147472639
\n
\n\n\n\n
\n\n
ColorMaroon = 2147483903
\n
\n\n\n\n
\n\n
ColourMaroon = 2147483903
\n
\n\n\n\n
\n\n
ColorPurple = 2147516671
\n
\n\n\n\n
\n\n
ColourPurple = 2147516671
\n
\n\n\n\n
\n\n
ColorOlive = 2155872511
\n
\n\n\n\n
\n\n
ColourOlive = 2155872511
\n
\n\n\n\n
\n\n
ColorGray = 2155905279
\n
\n\n\n\n
\n\n
ColourGray = 2155905279
\n
\n\n\n\n
\n\n
ColorGrey = 2155905279
\n
\n\n\n\n
\n\n
ColourGrey = 2155905279
\n
\n\n\n\n
\n\n
ColorSkyBlue = 2278484991
\n
\n\n\n\n
\n\n
ColourSkyBlue = 2278484991
\n
\n\n\n\n
\n\n
ColorLightSkyBlue = 2278488831
\n
\n\n\n\n
\n\n
ColourLightSkyBlue = 2278488831
\n
\n\n\n\n
\n\n
ColorBlueViolet = 2318131967
\n
\n\n\n\n
\n\n
ColourBlueViolet = 2318131967
\n
\n\n\n\n
\n\n
ColorDarkRed = 2332033279
\n
\n\n\n\n
\n\n
ColourDarkRed = 2332033279
\n
\n\n\n\n
\n\n
ColorDarkMagenta = 2332068863
\n
\n\n\n\n
\n\n
ColourDarkMagenta = 2332068863
\n
\n\n\n\n
\n\n
ColorSaddleBrown = 2336560127
\n
\n\n\n\n
\n\n
ColourSaddleBrown = 2336560127
\n
\n\n\n\n
\n\n
ColorDarkSeaGreen = 2411499519
\n
\n\n\n\n
\n\n
ColourDarkSeaGreen = 2411499519
\n
\n\n\n\n
\n\n
ColorLightGreen = 2431553791
\n
\n\n\n\n
\n\n
ColourLightGreen = 2431553791
\n
\n\n\n\n
\n\n
ColorMediumPurple = 2473647103
\n
\n\n\n\n
\n\n
ColourMediumPurple = 2473647103
\n
\n\n\n\n
\n\n
ColorDarkViolet = 2483082239
\n
\n\n\n\n
\n\n
ColourDarkViolet = 2483082239
\n
\n\n\n\n
\n\n
ColorPaleGreen = 2566625535
\n
\n\n\n\n
\n\n
ColourPaleGreen = 2566625535
\n
\n\n\n\n
\n\n
ColorDarkOrchid = 2570243327
\n
\n\n\n\n
\n\n
ColourDarkOrchid = 2570243327
\n
\n\n\n\n
\n\n
ColorYellowGreen = 2597139199
\n
\n\n\n\n
\n\n
ColourYellowGreen = 2597139199
\n
\n\n\n\n
\n\n
ColorSienna = 2689740287
\n
\n\n\n\n
\n\n
ColourSienna = 2689740287
\n
\n\n\n\n
\n\n
ColorBrown = 2771004159
\n
\n\n\n\n
\n\n
ColourBrown = 2771004159
\n
\n\n\n\n
\n\n
ColorDarkGray = 2846468607
\n
\n\n\n\n
\n\n
ColourDarkGray = 2846468607
\n
\n\n\n\n
\n\n
ColorDarkGrey = 2846468607
\n
\n\n\n\n
\n\n
ColourDarkGrey = 2846468607
\n
\n\n\n\n
\n\n
ColorLightBlue = 2916673279
\n
\n\n\n\n
\n\n
ColourLightBlue = 2916673279
\n
\n\n\n\n
\n\n
ColorGreenYellow = 2919182335
\n
\n\n\n\n
\n\n
ColourGreenYellow = 2919182335
\n
\n\n\n\n
\n\n
ColorPaleTurquoise = 2951671551
\n
\n\n\n\n
\n\n
ColourPaleTurquoise = 2951671551
\n
\n\n\n\n
\n\n
ColorLightSteelBlue = 2965692159
\n
\n\n\n\n
\n\n
ColourLightSteelBlue = 2965692159
\n
\n\n\n\n
\n\n
ColorPowderBlue = 2967529215
\n
\n\n\n\n
\n\n
ColourPowderBlue = 2967529215
\n
\n\n\n\n
\n\n
ColorFireBrick = 2988581631
\n
\n\n\n\n
\n\n
ColourFireBrick = 2988581631
\n
\n\n\n\n
\n\n
ColorDarkGoldenRod = 3095792639
\n
\n\n\n\n
\n\n
ColourDarkGoldenRod = 3095792639
\n
\n\n\n\n
\n\n
ColorMediumOrchid = 3126187007
\n
\n\n\n\n
\n\n
ColourMediumOrchid = 3126187007
\n
\n\n\n\n
\n\n
ColorRosyBrown = 3163525119
\n
\n\n\n\n
\n\n
ColourRosyBrown = 3163525119
\n
\n\n\n\n
\n\n
ColorDarkKhaki = 3182914559
\n
\n\n\n\n
\n\n
ColourDarkKhaki = 3182914559
\n
\n\n\n\n
\n\n
ColorSilver = 3233857791
\n
\n\n\n\n
\n\n
ColourSilver = 3233857791
\n
\n\n\n\n
\n\n
ColorMediumVioletRed = 3340076543
\n
\n\n\n\n
\n\n
ColourMediumVioletRed = 3340076543
\n
\n\n\n\n
\n\n
ColorIndianRed = 3445382399
\n
\n\n\n\n
\n\n
ColourIndianRed = 3445382399
\n
\n\n\n\n
\n\n
ColorPeru = 3448061951
\n
\n\n\n\n
\n\n
ColourPeru = 3448061951
\n
\n\n\n\n
\n\n
ColorChocolate = 3530104575
\n
\n\n\n\n
\n\n
ColourChocolate = 3530104575
\n
\n\n\n\n
\n\n
ColorTan = 3535047935
\n
\n\n\n\n
\n\n
ColourTan = 3535047935
\n
\n\n\n\n
\n\n
ColorLightGray = 3553874943
\n
\n\n\n\n
\n\n
ColourLightGray = 3553874943
\n
\n\n\n\n
\n\n
ColorLightGrey = 3553874943
\n
\n\n\n\n
\n\n
ColourLightGrey = 3553874943
\n
\n\n\n\n
\n\n
ColorThistle = 3636451583
\n
\n\n\n\n
\n\n
ColourThistle = 3636451583
\n
\n\n\n\n
\n\n
ColorOrchid = 3664828159
\n
\n\n\n\n
\n\n
ColourOrchid = 3664828159
\n
\n\n\n\n
\n\n
ColorGoldenRod = 3668254975
\n
\n\n\n\n
\n\n
ColourGoldenRod = 3668254975
\n
\n\n\n\n
\n\n
ColorPaleVioletRed = 3681588223
\n
\n\n\n\n
\n\n
ColourPaleVioletRed = 3681588223
\n
\n\n\n\n
\n\n
ColorCrimson = 3692313855
\n
\n\n\n\n
\n\n
ColourCrimson = 3692313855
\n
\n\n\n\n
\n\n
ColorGainsboro = 3705462015
\n
\n\n\n\n
\n\n
ColourGainsboro = 3705462015
\n
\n\n\n\n
\n\n
ColorPlum = 3718307327
\n
\n\n\n\n
\n\n
ColourPlum = 3718307327
\n
\n\n\n\n
\n\n
ColorBurlyWood = 3736635391
\n
\n\n\n\n
\n\n
ColourBurlyWood = 3736635391
\n
\n\n\n\n
\n\n
ColorLightCyan = 3774873599
\n
\n\n\n\n
\n\n
ColourLightCyan = 3774873599
\n
\n\n\n\n
\n\n
ColorLavender = 3873897215
\n
\n\n\n\n
\n\n
ColourLavender = 3873897215
\n
\n\n\n\n
\n\n
ColorDarkSalmon = 3918953215
\n
\n\n\n\n
\n\n
ColourDarkSalmon = 3918953215
\n
\n\n\n\n
\n\n
ColorViolet = 4001558271
\n
\n\n\n\n
\n\n
ColourViolet = 4001558271
\n
\n\n\n\n
\n\n
ColorPaleGoldenRod = 4008225535
\n
\n\n\n\n
\n\n
ColourPaleGoldenRod = 4008225535
\n
\n\n\n\n
\n\n
ColorLightCoral = 4034953471
\n
\n\n\n\n
\n\n
ColourLightCoral = 4034953471
\n
\n\n\n\n
\n\n
ColorKhaki = 4041641215
\n
\n\n\n\n
\n\n
ColourKhaki = 4041641215
\n
\n\n\n\n
\n\n
ColorAliceBlue = 4042850303
\n
\n\n\n\n
\n\n
ColourAliceBlue = 4042850303
\n
\n\n\n\n
\n\n
ColorHoneyDew = 4043305215
\n
\n\n\n\n
\n\n
ColourHoneyDew = 4043305215
\n
\n\n\n\n
\n\n
ColorAzure = 4043309055
\n
\n\n\n\n
\n\n
ColourAzure = 4043309055
\n
\n\n\n\n
\n\n
ColorSandyBrown = 4104413439
\n
\n\n\n\n
\n\n
ColourSandyBrown = 4104413439
\n
\n\n\n\n
\n\n
ColorWheat = 4125012991
\n
\n\n\n\n
\n\n
ColourWheat = 4125012991
\n
\n\n\n\n
\n\n
ColorBeige = 4126530815
\n
\n\n\n\n
\n\n
ColourBeige = 4126530815
\n
\n\n\n\n
\n\n
ColorWhiteSmoke = 4126537215
\n
\n\n\n\n
\n\n
ColourWhiteSmoke = 4126537215
\n
\n\n\n\n
\n\n
ColorMintCream = 4127193855
\n
\n\n\n\n
\n\n
ColourMintCream = 4127193855
\n
\n\n\n\n
\n\n
ColorGhostWhite = 4177068031
\n
\n\n\n\n
\n\n
ColourGhostWhite = 4177068031
\n
\n\n\n\n
\n\n
ColorSalmon = 4202722047
\n
\n\n\n\n
\n\n
ColourSalmon = 4202722047
\n
\n\n\n\n
\n\n
ColorAntiqueWhite = 4209760255
\n
\n\n\n\n
\n\n
ColourAntiqueWhite = 4209760255
\n
\n\n\n\n
\n\n
ColorLinen = 4210091775
\n
\n\n\n\n
\n\n
ColourLinen = 4210091775
\n
\n\n\n\n
\n\n
ColorLightGoldenRodYellow = 4210742015
\n
\n\n\n\n
\n\n
ColourLightGoldenRodYellow = 4210742015
\n
\n\n\n\n
\n\n
ColorOldLace = 4260751103
\n
\n\n\n\n
\n\n
ColourOldLace = 4260751103
\n
\n\n\n\n
\n\n
ColorRed = 4278190335
\n
\n\n\n\n
\n\n
ColourRed = 4278190335
\n
\n\n\n\n
\n\n
ColorFuchsia = 4278255615
\n
\n\n\n\n
\n\n
ColourFuchsia = 4278255615
\n
\n\n\n\n
\n\n
ColorMagenta = 4278255615
\n
\n\n\n\n
\n\n
ColourMagenta = 4278255615
\n
\n\n\n\n
\n\n
ColorDeepPink = 4279538687
\n
\n\n\n\n
\n\n
ColourDeepPink = 4279538687
\n
\n\n\n\n
\n\n
ColorOrangeRed = 4282712319
\n
\n\n\n\n
\n\n
ColourOrangeRed = 4282712319
\n
\n\n\n\n
\n\n
ColorTomato = 4284696575
\n
\n\n\n\n
\n\n
ColourTomato = 4284696575
\n
\n\n\n\n
\n\n
ColorHotPink = 4285117695
\n
\n\n\n\n
\n\n
ColourHotPink = 4285117695
\n
\n\n\n\n
\n\n
ColorCoral = 4286533887
\n
\n\n\n\n
\n\n
ColourCoral = 4286533887
\n
\n\n\n\n
\n\n
ColorDarkOrange = 4287365375
\n
\n\n\n\n
\n\n
ColourDarkOrange = 4287365375
\n
\n\n\n\n
\n\n
ColorLightSalmon = 4288707327
\n
\n\n\n\n
\n\n
ColourLightSalmon = 4288707327
\n
\n\n\n\n
\n\n
ColorOrange = 4289003775
\n
\n\n\n\n
\n\n
ColourOrange = 4289003775
\n
\n\n\n\n
\n\n
ColorLightPink = 4290167295
\n
\n\n\n\n
\n\n
ColourLightPink = 4290167295
\n
\n\n\n\n
\n\n
ColorPink = 4290825215
\n
\n\n\n\n
\n\n
ColourPink = 4290825215
\n
\n\n\n\n
\n\n
ColorGold = 4292280575
\n
\n\n\n\n
\n\n
ColourGold = 4292280575
\n
\n\n\n\n
\n\n
ColorPeachPuff = 4292524543
\n
\n\n\n\n
\n\n
ColourPeachPuff = 4292524543
\n
\n\n\n\n
\n\n
ColorNavajoWhite = 4292783615
\n
\n\n\n\n
\n\n
ColourNavajoWhite = 4292783615
\n
\n\n\n\n
\n\n
ColorMoccasin = 4293178879
\n
\n\n\n\n
\n\n
ColourMoccasin = 4293178879
\n
\n\n\n\n
\n\n
ColorBisque = 4293182719
\n
\n\n\n\n
\n\n
ColourBisque = 4293182719
\n
\n\n\n\n
\n\n
ColorMistyRose = 4293190143
\n
\n\n\n\n
\n\n
ColourMistyRose = 4293190143
\n
\n\n\n\n
\n\n
ColorBlanchedAlmond = 4293643775
\n
\n\n\n\n
\n\n
ColourBlanchedAlmond = 4293643775
\n
\n\n\n\n
\n\n
ColorPapayaWhip = 4293907967
\n
\n\n\n\n
\n\n
ColourPapayaWhip = 4293907967
\n
\n\n\n\n
\n\n
ColorLavenderBlush = 4293981695
\n
\n\n\n\n
\n\n
ColourLavenderBlush = 4293981695
\n
\n\n\n\n
\n\n
ColorSeaShell = 4294307583
\n
\n\n\n\n
\n\n
ColourSeaShell = 4294307583
\n
\n\n\n\n
\n\n
ColorCornsilk = 4294499583
\n
\n\n\n\n
\n\n
ColourCornsilk = 4294499583
\n
\n\n\n\n
\n\n
ColorLemonChiffon = 4294626815
\n
\n\n\n\n
\n\n
ColourLemonChiffon = 4294626815
\n
\n\n\n\n
\n\n
ColorFloralWhite = 4294635775
\n
\n\n\n\n
\n\n
ColourFloralWhite = 4294635775
\n
\n\n\n\n
\n\n
ColorSnow = 4294638335
\n
\n\n\n\n
\n\n
ColourSnow = 4294638335
\n
\n\n\n\n
\n\n
ColorYellow = 4294902015
\n
\n\n\n\n
\n\n
ColourYellow = 4294902015
\n
\n\n\n\n
\n\n
ColorLightYellow = 4294959359
\n
\n\n\n\n
\n\n
ColourLightYellow = 4294959359
\n
\n\n\n\n
\n\n
ColorIvory = 4294963455
\n
\n\n\n\n
\n\n
ColourIvory = 4294963455
\n
\n\n\n\n
\n\n
ColorWhite = 4294967295
\n
\n\n\n\n
\n\n
ColourWhite = 4294967295
\n
\n\n\n\n
\n\n
\n
\n

Procs

\n
\n\n
proc `==`(c1, c2: Coord): bool {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `-`(c: Coord): Coord {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `+`(c1, c2: Coord): Coord {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `+=`(c1: var Coord; c2: Coord) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `-`(c1, c2: Coord): Coord {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `-=`(c1: var Coord; c2: Coord) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `*`(c1, c2: Coord): Coord {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `*=`(c1: var Coord; c2: Coord) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `/`(c1, c2: Coord): Coord {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `/=`(c1: var Coord; c2: Coord) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `+`(c: Coord; v: float): Coord {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `+=`(c: var Coord; v: float) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `-`(c: Coord; v: float): Coord {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `-=`(c: var Coord; v: float) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `*`(c: Coord; v: float): Coord {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `*=`(c: var Coord; v: float) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `/`(c: Coord; v: float): Coord {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `/=`(c: var Coord; v: float) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc abs(c: Coord): Coord {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc sin(c: Coord): Coord {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc arcsin(c: Coord): Coord {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `==`(c1, c2: CoordInt): bool {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `-`(c: CoordInt): CoordInt {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `+`(c1, c2: CoordInt): CoordInt {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `+=`(c1: var CoordInt; c2: CoordInt) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `-`(c1, c2: CoordInt): CoordInt {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `-=`(c1: var CoordInt; c2: CoordInt) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `*`(c1, c2: CoordInt): CoordInt {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `*=`(c1: var CoordInt; c2: CoordInt) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `div`(c1, c2: CoordInt): CoordInt {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc div=(c1: var CoordInt; c2: CoordInt) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `+`(c: CoordInt; v: int): CoordInt {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `+=`(c: var CoordInt; v: int) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `-`(c: CoordInt; v: int): CoordInt {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `-=`(c: var CoordInt; v: int) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `*`(c: CoordInt; v: int): CoordInt {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `*=`(c: var CoordInt; v: int) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `div`(c: CoordInt; v: int): CoordInt {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc div=(c: var CoordInt; v: int) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc abs(c: CoordInt): CoordInt {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `==`(d1, d2: Dim): bool {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `+`(d1, d2: Dim): Dim {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `+=`(d1: var Dim; d2: Dim) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `-`(d1, d2: Dim): Dim {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `-=`(d1: var Dim; d2: Dim) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `*`(d1, d2: Dim): Dim {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `*=`(d1: var Dim; d2: Dim) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `/`(d1, d2: Dim): Dim {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `/=`(d1: var Dim; d2: Dim) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `+`(d: Dim; v: int): Dim {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `+=`(d: var Dim; v: int) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `-`(d: Dim; v: int): Dim {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `-=`(d: var Dim; v: int) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `*`(d: Dim; v: int): Dim {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `*=`(d: var Dim; v: int) {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `/`(d: Dim; v: int): Dim {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
proc `/=`(d: var Dim; v: int): Dim {...}{.inline, raises: [], tags: [].}
\n
\n\n\n\n
\n\n
\n
\n

Converters

\n
\n\n
converter toSeq[T](s: Slice[T]): seq[T]
\n
\n\n\n\n
\n\n
converter toUint32(c: Color): uint32 {...}{.raises: [], tags: [].}
\n
\n\nColor(r, g, b, a) to 0xRRGGBBAA \n\n
\n\n
converter toColor(u: uint32): Color {...}{.raises: [], tags: [].}
\n
\n\n0xRRGGBBAA to Color(r, g, b, a) \n\n
\n\n
converter toDim(c: Coord): Dim {...}{.raises: [], tags: [].}
\n
\n\n\n\n
\n\n
converter toDim(c: CoordInt): Dim {...}{.raises: [], tags: [].}
\n
\n\n\n\n
\n\n
converter toCoord(d: Dim): Coord {...}{.raises: [], tags: [].}
\n
\n\n\n\n
\n\n
\n
\n

Templates

\n
\n\n
template neg(c: Color): Color
\n
\n\n\nReturn negative to color c.\n\n
\n\n
template `+`(v: float; c: Coord): Coord
\n
\n\n\n\n
\n\n
template `-`(v: float; c: Coord): Coord
\n
\n\n\n\n
\n\n
template `*`(v: float; c: Coord): Coord
\n
\n\n\n\n
\n\n
template `+`(v: int; c: CoordInt): CoordInt
\n
\n\n\n\n
\n\n
template `-`(v: int; c: CoordInt): CoordInt
\n
\n\n\n\n
\n\n
template `*`(v: int; c: CoordInt): CoordInt
\n
\n\n\n\n
\n\n
template `*`(transform: Transform; point: Coord): Coord
\n
\n\n\n\n
\n\n
template local(transform: Transform): Transform
\n
\n\n\n\n
\n\n
\n\n
\n
\n\n
\n
\n \n
\n Made with Nim. Generated: 2019-06-15 20:16:27 UTC\n
\n
\n
\n
\n\n\n\n" }, { "path": "docs/docs/typewriter.html", "content": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\ntypewriter\n\n\n\n\n\n\n\n\n
\n
\n

typewriter

\n
\n
\n
\n
    \n
\n
\n
\n Search: \n
\n
\n Group by:\n \n
\n \n\n
\n
\n
\n

\n \n
\n

Types

\n
\n\n
Typewriter = ref object of Entity\n  fText: seq[char]             ## typewriter's queue\n  fRemainder: float            ## internal timer (in seconds)\n  rate*: float                 ## typewriter's rate (in seconds)\n  width*: int                  ## line width limit, no limit if `0` (default)\n
\n
\n\n\n
\n\n
\n
\n

Procs

\n
\n\n
proc newTypewriter(text: TextGraphic; rate: float): Typewriter {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
proc add(tw: Typewriter; text: string) {...}{.inline, raises: [], tags: [].}
\n
\nAdd new text to the typewriter's queue. \n\n
\n\n
proc dump(tw: Typewriter): string {...}{.inline, raises: [], tags: [].}
\n
\nReturn the text awaiting in the typewriter's queue. \n\n
\n\n
proc clear(tw: Typewriter) {...}{.inline, raises: [], tags: [].}
\n
\nDelete the text awaiting in the typewriter's queue. \n\n
\n\n
proc force(tw: Typewriter; text: string = "") {...}{.raises: [Exception], tags: [RootEffect].}
\n
\nAdd new text to the typewriter's queue and then output it all immediately. \n\n
\n\n
proc updateTypewriter(tw: Typewriter; elapsed: float) {...}{.raises: [Exception],\n    tags: [RootEffect].}
\n
\n\n\n
\n\n
\n
\n

Methods

\n
\n\n
method update(tw: Typewriter; elapsed: float) {...}{.raises: [Exception], tags: [RootEffect].}
\n
\n\n\n
\n\n
\n\n
\n
\n\n
\n
\n \n
\n Made with Nim. Generated: 2019-01-21 14:58:43 UTC\n
\n
\n
\n
\n\n\n\n" }, { "path": "docs/docs/utils.html", "content": "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\nutils\n\n\n\n\n\n\n\n\n
\n
\n

utils

\n
\n
\n
\n
    \n
\n
\n
\n Search: \n
\n
\n Group by:\n \n
\n \n\n
\n
\n
\n

\n \n
\n

Types

\n
\n\n
Counter = ref object\n  counter, current, interval: int\n  time: uint64\n
\n
\n\n\n
\n\n
\n
\n

Procs

\n
\n\n
proc distance(a, b: Coord): float {...}{.inline, raises: [], tags: [].}
\n
\nReturn distance between two coordinates. \n\n
\n\n
proc distanceToLine(a, d1, d2: Coord): float {...}{.raises: [], tags: [].}
\n
\nReturn distance between point a and line d1-d2. \n\n
\n\n
proc direction(a, b: Coord): Angle {...}{.raises: [], tags: [].}
\n
\nReturn angle direction from coordinate a to b (in degrees). \n\n
\n\n
proc rotate(a: Coord; angle: Angle): Coord {...}{.raises: [], tags: [].}
\n
\nRotate point a by the given angle (in degrees). \n\n
\n\n
proc rotate(point, offset: Coord; angle: Angle): Coord {...}{.raises: [], tags: [].}
\n
\n

Rotate point by the given angle and with given offset.

\n

offset Offset coordinate (parent position) point Point to rotate angle Angle of rotation (in degrees)

\n\n\n
\n\n
proc loadSurface(file: string): Surface {...}{.raises: [], tags: [].}
\n
\n

Load an image file to the sdl.Surface.

\n

Return the surface on success, or nil otherwise.

\n\n\n
\n\n
proc loadSurface(src: ptr RWops; freeSrc: bool = true): Surface {...}{.raises: [], tags: [].}
\n
\n

Load src RWops to the sdl.Surface.

\n

Return the surface on success, or nil otherwise.

\n\n\n
\n\n
proc textureFormats(renderer: Renderer): tuple[num: uint32,\n    formats: array[16, uint32]] {...}{.raises: [], tags: [].}
\n
\nReturn number and array of available texture formats from the renderer. \n\n
\n\n
proc textureFormat(renderer: Renderer; n: uint32 = 0): uint32 {...}{.raises: [], tags: [].}
\n
\nReturn n'th texture format from the renderer. \n\n
\n\n
proc readAll(src: ptr RWops): string {...}{.raises: [Exception], tags: [RootEffect].}
\n
\n\n\n
\n\n
proc loadCSV[T](file: string; parse: proc (input: string): T; separator = ',';\n               quote = '\\"'; escape = '\\x00'; skipInitialSpace = true): seq[seq[T]]
\n
\n

Load data from a CSV file.

\n

Return a two-dimensional sequence of values from the file, or empty sequence (@[]) otherwise.

\n\n\n
\n\n
proc loadCSV[T](src: ptr RWops; file: string; parse: proc (input: string): T;\n               separator = ','; quote = '\\"'; escape = '\\x00'; skipInitialSpace = true;\n               freeSrc = true): seq[seq[T]]
\n
\n

Load data from src RWops.

\n

file is only used for nice error messages.

\n

Return a two-dimensional sequence of values from the file, or empty sequence (@[]) otherwise.

\n\n\n
\n\n
proc loadPalette(palette: var indexedimage.Palette; file: string; separator = ' ';\n                quote = '\\"'; escape = '\\x00'; skipInitialSpace = true) {...}{.\n    raises: [CsvError, Exception, OverflowError, ValueError, IndexError],\n    tags: [ReadIOEffect].}
\n
\n

Load palette color data from a file.

\n

palette Target palette. If palette is nil, allocates a new palette, otherwise the palette will be freed.

\n

Data file should be in a format of:

\n

rrr ggg bbb aaa ...

\n

or

\n

rrr ggg bbb

\n

where rrr, ggg, bbb, and aaa is in 0..`255` range.

\n

Other types of lines are ignored.

\n\n\n
\n\n
proc loadPalette(palette: var indexedimage.Palette; src: ptr RWops; file: string;\n                separator = ' '; quote = '\\"'; escape = '\\x00'; skipInitialSpace = true;\n                freeSrc = true) {...}{.raises: [Exception, CsvError, OverflowError,\n                                       ValueError, IndexError],\n                               tags: [RootEffect, ReadIOEffect].}
\n
\n\n\n
\n\n
proc random[T](max: T; exclude: seq[T]): T {...}{.deprecated.}
\n
\n

Return a random number in the range 0..<max, except values in the exclude.

\n

Deprecated: Use rand instead.

\n\n\n
\n\n
proc rand[T](max: T; exclude: seq[T]): T
\n
\nReturn a random number in the range 0..``max``, except values in the exclude. \n\n
\n\n
proc rand[T](max: T; exclude: openArray[T]): T {...}{.inline.}
\n
\n\n\n
\n\n
proc random[T](x, exclude: seq[T]): T {...}{.deprecated.}
\n
\n

Return a random number in the sequence x, except values in the exclude.

\n

Deprecated: use rand instaead.

\n\n\n
\n\n
proc rand[T](x, exclude: seq[T]): T
\n
\nReturn a random number in the sequence x, except values in the exclude. \n\n
\n\n
proc rand[T](x, exclude: openArray[T]): T {...}{.inline.}
\n
\n\n\n
\n\n
proc random[T](x: Slice[T]; exclude: seq[T]): T {...}{.deprecated.}
\n
\n

Return a random number in the range min..<max, except values in the exclude.

\n

Deprecated: use rand instead.

\n\n\n
\n\n
proc rand[T](x: Slice[T]; exclude: seq[T]): T
\n
\nReturn a random number in the range min..``max``, except values in the exclude. \n\n
\n\n
proc rand[T](x: Slice[T]; exclude: openArray[T]): T {...}{.inline.}
\n
\n\n\n
\n\n
proc random[T](x: set[T]): T {...}{.deprecated.}
\n
\n

Return a random member of set x.

\n

Deprecated: use rand instead.

\n\n\n
\n\n
proc rand[T](x: set[T]): T
\n
\nReturn a random member of set x. \n\n
\n\n
proc randomBool(chance: float = 0.5): bool {...}{.deprecated, raises: [], tags: [].}
\n
\nReturn true or false, based on the chance value (from 0.0 to 1.0). \n\n
\n\n
proc randBool(chance: float = 0.5): bool {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc randomSign(chance: float = 0.5): int {...}{.raises: [], tags: [].}
\n
\nReturn 1 or -1, based on the chance value (from 0.0 to 1.0). \n\n
\n\n
proc randSign(chance: float = 0.5): int {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
proc randomWeighted[T](weights: openArray[T]): int
\n
\n

Return a random integer, based on the weights array.

\n

E.g., call of randomWeighted([2, 3, 5]) will have a 20% chance of returning 0, 30% chance of returning 1, and 50% chance of returning 2.

\n\n\n
\n\n
proc randWeighted[T](weights: openArray[T]): int {...}{.inline.}
\n
\n\n\n
\n\n
proc newCounter(interval: int = 1000): Counter {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc update(counter: Counter) {...}{.raises: [], tags: [].}
\n
\n\n\n
\n\n
proc value(counter: Counter): int {...}{.inline, raises: [], tags: [].}
\n
\n\n\n
\n\n
\n
\n

Iterators

\n
\n\n
iterator atlasValues(file: string; separator = ','; quote = '\\"'; escape = '\\x00';\n                    skipInitialSpace = true): tuple[name: string, rect: Rect] {...}{.\n    raises: [CsvError, Exception, OverflowError, ValueError], tags: [ReadIOEffect].}
\n
\n

Load and iterate over atlas mapping file.

\n

Mapping should be in a format of:

\n

name, x, y, w, h ...

\n\n\n
\n\n
iterator atlasValues(src: ptr RWops; file: string; separator = ','; quote = '\\"';\n                    escape = '\\x00'; skipInitialSpace = true; freeSrc = true): tuple[\n    name: string, rect: Rect] {...}{.raises: [Exception, CsvError, OverflowError, ValueError],\n                            tags: [RootEffect, ReadIOEffect].}
\n
\n\n\n
\n\n
\n
\n

Templates

\n
\n\n
template rad(a: Angle): Angle
\n
\nConvert degrees to radians. \n\n
\n\n
template deg(a: Angle): Angle
\n
\nConvert radians to degrees. \n\n
\n\n
template random[T](max: T; exclude: openArray[T]): T {...}{.deprecated.}
\n
\n\n\n
\n\n
template random[T](x, exclude: openArray[T]): T {...}{.deprecated.}
\n
\n\n\n
\n\n
template random[T](x: Slice[T]; exclude: openArray[T]): T {...}{.deprecated.}
\n
\n\n\n
\n\n
template timeDiff(first, second: untyped): untyped
\n
\n

\nfirst, second two results of sdl.getPerformanceCounter().

\n

Return time difference between two time stamps (in ms).

\n\n\n
\n\n
template msToSec(ms: int): float
\n
\n\n\n
\n\n
template secToMs(sec: float): int
\n
\n\n\n
\n\n
\n\n
\n
\n\n
\n
\n \n
\n Made with Nim. Generated: 2019-01-21 14:58:43 UTC\n
\n
\n
\n
\n\n\n\n" }, { "path": "docs/docs.html", "content": "\n\n\n \n\n Nimgame 2\n\n \n\n\n\n\n\n
\n
\n\n
\n\n \n\n
\n

DOCUMENTATION

\n
\n
\n
\n
\n
\n
\n\n
\n\n\n\n\n\n\n\n\n\n\n" }, { "path": "docs/index.html", "content": "\n\n\n \n\n Nimgame 2\n\n \n\n\n\n\n\n
\n
\n\n
\n \n\n
\n

\n Nimgame 2 is a simple 2D game engine for Nim language.\n

\n\n
\n\n

\n Status: v0.6.1 alpha.\n

\n\n

\n About: The engine is written in Nim, and built on top of SDL2 library through the SDL2_nim wrapper.\n

\n\n

\n The purpose of Nimgame 2 is to provide a comfort layer over the SDL2 procedures, creating a minimalist and simple to understand 2D game engine.\n

\n\n

\n Changelog\n

\n\n
\n\n
\n
\n

Checklist of features

\n
    \n
  • scene/entity system
    • \n
  • assets manager
    • \n
  • audio\n
      \n
    • sound
      • \n
    • music
      • \n
    • playlists
      • \n
    \n
    • \n
  • camera
    • \n
  • colliders
    • \n
  • drawing
    • \n
  • emitters
    • \n
  • fonts\n
      \n
    • bitmap
      • \n
    • TrueType
      • \n
    \n
    • \n
  • GUI\n
      \n
    • buttons
      • \n
    • progress bar
      • \n
    • radio groups and buttons
      • \n
    • text input
      • \n
    • …
      • \n
    \n
    • \n
  • indexed images (palette manipulation)
    • \n
  • input\n
      \n
    • keyboard
      • \n
    • mouse
      • \n
    • joysticks
      • \n
    • gamepads
      • \n
    \n
    • \n
  • mosaic
    • \n
  • parallax
    • \n
  • perspective images (perspective manipulation)
    • \n
  • simple physics\n
      \n
    • default (\"space\")
      • \n
    • platformer
      • \n
    \n
    • \n
  • texture atlas
    • \n
  • tilemaps
    • \n
  • typewriter (text animation effect)
    • \n
  • tweens
    • \n
  • window management
    • \n
  • plugins\n
      \n
    • MPEG video support
      • \n
    • TAR archive support
      • \n
    • ZIP archive support
      • \n
    \n
    • \n
\n
\n\n
\n

Screenshots

\n
\n \n \"Two-Button\n \n
\n \n Two-Button Knight\n
\n
\n
\n \n \"Glorious\n \n
\n \n Glorious Glacier Grotto\n
\n
\n
\n \n \"Planetoids\n \n
\n \n Planetoids\n
\n
\n\n
\n \n \"Platformer\n \n
\n \n Platformer tutorial\n
\n
\n\n
\n \n \"Demo14\n \n
\n \n Demo14, using sprites, tilemaps, tweens, and emitters\n
\n
\n
\n
\n
\n\n
\n\n\n\n\n\n\n\n\n\n" }, { "path": "docs/links.html", "content": "\n\n\n \n\n Nimgame 2\n\n \n\n\n\n\n\n
\n
\n\n
\n\n \n\n
\n\n\n\n\n\n\n\n\n" }, { "path": "docs/snippets.html", "content": "\n\n\n \n\n Nimgame 2\n\n \n\n\n\n\n\n
\n
\n\n
\n\n \n\n
\n

SNIPPETS

\n\n

Engine Initialization

\n
\n  # mygame.nim\n\n  import\n      nimgame2 / [\n        nimgame,\n        settings,\n      ]\n      mainscene # your first scene\n\n\n  game = newGame()\n  if game.init(w = 640, h = 480, title = \"My Awesome Game\"):\n      game.scene = newMainScene() # your scene constructor\n      game.run()\n
\n\n

Scene Initialization

\n
\n  # mainscene.nim\n\n  import\n    nimgame2 / [\n      nimgame,\n      entity,\n      scene,\n      settings,\n      texturegraphic,\n      types\n    ]\n\n\n  type\n    MainScene = ref object of Scene\n      myGraphic: TextureGraphic\n      myEntity: Entity\n\n\n  proc init*(scene: MainScene) =\n    # don't forget the parent initialization!\n    Scene(scene).init()\n\n    # create the graphic\n    scene.myGraphic = newTextureGraphic()\n    # load graphic file\n    discard scene.myGraphic.load(\"data/gfx/my_image.png\")\n\n    # create the entity\n    scene.myEntity = newEntity()\n    # assign the graphic to the entity\n    scene.myEntity.graphic = scene.myGraphic\n\n    # add your entity to the scene\n    scene.add(scene.myEntity)\n\n\n  proc free*(scene: MainScene) =\n    # free the texture\n    scene.myGraphic.free()\n\n\n  proc newMainScene*(): MainScene =\n    # scene constructor\n    new result, free\n    result.init()\n\n\n  method event*(scene: MainScene, event: Event) =\n    # call it if your entities have their own event handlers\n    scene.eventScene(event)\n    # if you want to handle some events manually, you do it here\n    if event.kind == KeyDown:\n      case event.key.keysym.scancode:\n      of ScancodeEscape:\n        # stop the engine (see nimgame2/settings.nim)\n        gameRunning = false\n      else: discard\n\n\n  method render*(scene: MainScene) =\n    # don't forget to call the parent render!\n    scene.renderScene()\n    # if you want to draw something on top of a rendered scene,\n    # you do it here\n\n\n  method update*(scene: MainScene, elapsed: float) =\n    # don't forget to call the parent update!\n    scene.updateScene(elapsed)\n    # scene-level logic goes here\n
\n\n

Entity Initialization

\n
\n  # myentity.nim\n\n  import\n    nimgame2 / [\n      nimgame,\n      entity,\n      texturegraphic,\n    ]\n\n\n  type\n    MyEntity* = ref object of Entity\n\n\n  proc init*(entity: MyEntity, graphic: TextureGraphic) =\n    # don't forget to call the parent initialization!\n    entity.initEntity()\n    # assign the graphic\n    entity.graphic = graphic\n    # set the center point\n    entity.centrify()\n    # assign the physics only if you need it\n    entity.physics = defaultPhysics\n\n\n  proc newMyEntity*(graphic: TextureGraphic): MyEntity =\n    # entity constructor\n    new result\n    result.init(graphic)\n\n\n  method update*(entity: MyEntity, elapsed: float) =\n    # don't forget to call the parent update!\n    entity.updateEntity(elapsed)\n    # entity-level logic goes here\n\n
\n\n

Keyboard Input

\n\n
\n  # somewhere in the update method\n\n    let move = 100 * elapsed\n    if ScancodeLeft.down: scene.player.pos.x -= move\n    if ScancodeRight.down: scene.player.pos.x += move\n    # the key was pressed\n    if ScancodeSpace.pressed: scene.player.startCharging()\n    # the key was relased\n    if ScancodeSpace.released: scene.player.discharge()\n
\n\n

Mouse Input

\n
\n  # somewhere in the update method\n\n    let mousePos = mouse.abs\n    if Button.left.down: scene.player.fireTo(mousePos)\n    # Mouse buttons (Button enum): left, middle, right, x1, x2\n
\n\n\n

Joystick Input

\n
\n  # somewhere in the initialization routine\n\n    for i in 0..<numJoysticks():\n      discard openJoystick(i)\n\n    scene.joy = 0\n\n  # somewhere in the update method\n\n    let move = 100 * elapsed / JoyAxis.high.float\n    scene.player.pos.x += scene.joy.joyAxis(0).float * move\n    scene.player.pos.y += scene.joy.joyAxis(1).float * move\n\n    # the button was pressed\n    if scene.joy.joyPressed(0): scene.player.startCharging()\n    # the button was released\n    if scene.joy.joyReleased(0): scene.player.discharge()\n
\n\n\n

Sprite Initialization

\n
\n  # somewhere in the entity initialization routine\n\n    # assign the graphic\n    entity.graphic = graphic\n    # set the sprite dimensions and offset\n    # (if the graphic has a border)\n    entity.initSprite((24, 48), offset = (16, 16))\n\n    # add animations\n    discard scene.d.addAnimation(\n      \"run_right\", [0, 1, 2, 3])\n    discard scene.d.addAnimation(\n      \"run_left\", [0, 1, 2, 3], flip = Flip.horizontal)\n\n    # or, if your frames are in order,\n    # use toSeq() from types.nim\n    discard scene.d.addAnimation(\n      \"jump_right\", toSeq(4..7))\n    discard scene.d.addAnimation(\n      \"jump_left\", toSeq(4..7), flip = Flip.horizontal)\n
\n\n

Collider Initialization

\n
\n  # somewhere in the entity initialization routine\n\n    entity.collider = newBoxCollider(entity, (0, 0), entity.graphic.dim)\n
\n\n

TextGraphic Usage

\n
\n  # somewhere in the scene initialization routine\n\n    # BitmapFont\n\n    # create a bitmap font\n    scene.bitmapFont = newBitmapFont()\n    # load the font file, giving the dimensions of a single character\n    discard scene.bitmapFont.load(\"data/font/bitmap.png\", (8, 16))\n    # create a text graphic\n    scene.bitmapText = newTextGraphic()\n    # assign the font\n    scene.bitmapText.font = scene.bitmapFont\n    # set the text\n    scene.bitmapText.lines =\n      [ \"Text line 1\",\n        \"Text line 2\"]\n    # create an entity\n    scene.bitmapEntity = newEntity()\n    # assign the graphic\n    scene.bitmapEntity.graphic = scene.bitmapText\n    # add to the scene\n    scene.add(scene.bitmapEntity)\n\n    # TrueTypeFont\n\n    # create a TrueType font\n    scene.trueTypeFont = newTrueTypeFont()\n    # load the font file, giving the font size\n    discard scene.trueTypeFont.load(\"data/font/truetype.ttf\", 16)\n    # create a text graphic\n    scene.trueTypeText = newTextGraphic()\n    # assign the font\n    scene.trueTypeText.font = scene.trueTypeFont\n    # set the text\n    scene.trueTypeText.lines =\n      [ \"Text line 1\",\n        \"Text line 2\"]\n    # create an entity\n    scene.trueTypeEntity = newEntity()\n    # assign the graphic\n    scene.trueTypeEntity.graphic = scene.trueTypeText\n    # add to the scene\n    scene.add(scene.trueTypeEntity)\n
\n\n

ProcGraphic Usage

\n
\n  # somewhere in the initialization routine\n\n  proc customProc(graphic: ProcGraphic,\n                  pos: Coord,\n                  angle: Angle,\n                  scale: Scale,\n                  center: Coord,\n                  flip: Flip,\n                  region: Rect) =\n    # your custom drawing routine goes here\n\n\n  proc init*(scene: MyScene) =\n    Scene(scene).init()\n    # create a ProcGraphic\n    scene.customGraphic = newProcGraphic()\n    # assign the procedure\n    scene.customGraphic.procedure = customProc\n    # create an entity\n    scene.myEntity = newEntity\n    # assign the graphic\n    scene.myEntity.graphic = scene.customGraphic\n    # add to the scene\n    scene.add(scene.myEntity)\n
\n\n

IndexedImage Usage

\n
\n# somewhere in the initialization routine\n\n  let myImage = newIndexedImage(\"data/gfx/unit.gif\")\n  var color = myImage.palette[8] # get palette color\n  color.r = 255\n  color.g = 0\n  color.b = 0\n  myImage.palette[8] = color # set palette color\n\n  # generate graphic\n  let myGraphic = newTextureGraphic()\n  discard myGraphic.assignTexture myImage.render()\n
\n\n

PerspectiveImage Usage

\n
\n# somewhere in the initialization routine\n\n  let myImage = newPerspectiveImage(\"data/gfx/pimage.png\")\n  let myGraphic = newTextureGraphic()\n  # render with distortion\n  myGraphic.assignTexture myImage.render(pdHor, 64, 32)\n  let myEntity = newEntity()\n  myEntith.graphic = myGrapghic\n  scene.add(myEntity)\n
\n\n

TextureAtlas Usage

\n
\n# somewhere in the initialization routine\n\n  let myAtlas = newTextureAtlas(\"data/gfx/atlas.png\", \"data/csv/atlas.csv\")\n  entity1.graphic = myAtlas[\"image1\"]\n  entity2.graphic = myAtlas[\"image2\"]\n
\n\n

Tween Usage

\n
\n  let tween = newTween[Entity,Coord](\n    target = myEntity,\n    get = proc(t: Entity): Coord = t.pos,\n    set = proc(t: Entity, val: Coord) = t.pos = val\n  )\n  tween.procedure = inQuad\n  tween.setup(\n    start = myEnttiy.pos,\n    finish = myEntityPos + (100.0, 0.0),\n    duration = 3.0,\n    loops = -1\n  )\n  tween.play()\n
\n\n

Emitter Usage

\n
\n  # somewhere in the initialization routine\n    # init emitter\n    myEmitter = newEmitter(myScene)\n    myEmitter.randomVel = (10.0, 10.0)\n    myEmitter.randomAcc = (5.0, 5.0)\n    myEmitter.randomTTL = 5.0\n    myScene.add(myEmitter)\n    # init emitter particle\n    myEmitter.particle = newParticle()\n    myEmitter.particle.graphic = myParticleGraphic\n    myEmitter.particle.initSprite((5, 5))\n    myEmitter.particle.centrify()\n    discard myEmitter.particle.addAnimation(\"play\", toSeq(0..4), 1/5)\n    myEmitter.particle.play(\"play\", 1, kill = true)\n\n  # somewhere in the update routine\n    if emitCondition:\n      myEmitter.emit(5) # emit 5 particles\n
\n\n\n

TileMap Usage

\n
\n  # somewhere in the initialization routine\n\n    # tiles\n    scene.tilesGraphic = newTextureGraphic()\n    discard scene.tilesGraphic.load(\"data/gfx/tile.png\")\n\n    # map\n    scene.map = newTileMap(scaleFix = true)\n    scene.map.graphic = scene.tilesGraphic\n    scene.map.initSprite((64, 64), offset = (0, 0))\n    scene.map.map = loadCSV[int](\n        \"data/csv/map.csv\",\n        proc(input: string): int = discard parseInt(input, result)\n    )\n    scene.map.passable.add(0)\n    scene.add(scene.map)\n
\n\n\n

TileMap Collision List

\n
\n  # checking specific tile collisions\n  let\n    collider = TilemapCollider(map.collider)\n    collisions = collider.collisionList(myEntity.collider)\n    for tile in collisions:\n      echo\n        \"Collided with \" & $tile.value & \" at \" & $tile.mapx & \":\" & $tile.mapy\n
\n\n\n

Camera Usage

\n
\n  # somewhere in the initialization routine\n\n    scene.camera = newEntity()\n\n    scene.map = newMyMap()\n    scene.map.parent = scene.camera # this entity is bound to the camera\n    scene.add(scene.map)\n\n    scene.player = newMyPlayer()\n    scene.player.parent = scene.map # this entity is bound to the map\n    scene.add(scene.player)\n\n    # this entity isn't bound to the camera\n    scene.ui = newUI()\n    scene.add(scene.ui)\n\n    # boud camera to this entity\n    scene.cameraBond = scene.player\n    # place camera bond entity at the center\n    scene.cameraBondOffset = game.size / 2\n\n  # somewhere in the update routine\n\n    if scene.cameraBond == nil:\n        if ScancodeRight.down: scene.camera.pos.x += step\n        # ...\n    else:\n        if ScancodeRight.down: scene.player.pos.x += step\n        # ...\n
\n\n\n

Sound Usage

\n
\n  # somewhere in the initialization routine\n\n    # load a sound file\n    scene.soundEffect = newSound(\"data/sfx/effect.wav\")\n    # set the volume\n    scene.soundEffect.volume = Volume.high div 2\n\n  # somewhere else\n\n    # the call\n    scene.soundEffect.play()\n
\n\n

Music Playlist Usage

\n
\n  # somewhere in the initialization routine\n\n    # load all music files\n    var musicData: Assets[Music]\n    musicData = newAssets[Music](\"data/music\",\n                                 proc(file: string): Music = newMusic(file))\n    # global playlist\n    playlist = newPlaylist()\n    # fill the playlist\n    for track in musicData.values:\n      playlist.list.add(track)\n\n  # somewhere else\n\n    # next random track\n    discard playlist.play()\n\n  # somewhere in the update routine\n\n    playlist.update()\n
\n\n

GUI: Buttons

\n
\n# mybutton.nim\n\nimport\n  nimgame2 / [\n    graphic,\n    input,\n    gui/button,\n  ]\n\ntype\n  MyButton* = ref object of GuiButton\n\nproc init*(btn: MyButton, graphic: Graphic, image: Graphic = nil) =\n  GuiButton(btn).init(graphic, image)\n\nproc newMyButton*(graphic: Graphic, image: Graphic = nil): MyButton =\n  new result\n  result.init(graphic, image)\n\nmethod onClick*(btn: MyButton, mb: MouseButton) =\n  echo \"clicked my button\"\n\n\n# somewhere in the initialization routine\n  # skin loading\n  let mySkin = newTextureGraphic()\n  discard mySkin.load(\"data/gfx/button_skin.png\")\n\n  # button initialization\n  myBtn = newMyButton(mySkin)\n  scene.add(myBtn)\n
\n\n\n

GUI: Actions

\n
\n# action procedure\nproc myBtnAction(widget: GuiWidget) =\n  echo \"clicked my button\"\n\n# somewhere in the initialization routine\n  # skin loading\n  let mySkin = newTextureGraphic()\n  discard mySkin.load(\"data/gfx/button_skin.png\")\n\n  # button initialization\n  myBtn = newGuiButton(mySkin)\n  myBtn.action = myBtnAction\n  scene.add(myBtn)\n
\n\n\n

GUI: Text Input (+ Mosaic)

\n
\nimport\n  nimgame2 / [\n    scene,\n    mosaic,\n    texturegraphic,\n    truetypefont,\n    gui/widget,\n    gui/textinput,\n  ]\n\n# somewhere in the initialization routine\n\n  # mosaic creation\n  let myMosaic = newMosaic(\"data/gfx/textinput_skin.png\")\n  let mySkin = newTextureGraphic()\n  discard mySkin.assignTexture myMosaic.render(patternStretchBorder(16, 1))\n\n  # text input initialization\n  myTextInput = newGuiTextInput(mySkin, myFont)\n  myTextInput.text.limit = 16 # set text length limit\n  scene.add(myTextInput)\n\n
\n\n

GUI: Radio Groups

\n
\nimport\n  nimgame2 / [\n    scene,\n    texturegraphic,\n    truetypefont,\n    gui/widget,\n    gui/radio,\n  ]\n\ntype\n  MyScene = ref object of Scene\n    radioButtons: array[3, GuiRadioButton]\n    radioGroup: GuiRadioGroup\n\n# somewhere in the initialization routine\n\n  scene.radioGroup = newGuiRadioGroup() # create group\n\n  # init each button\n  for i in 0..scene.radioButtons.high:\n    scene.radioButtons[i] = newGuiRadioButton(scene.radioGroup, scene.mySkin)\n\n  scene.radioButtons[0].toggled = true # toggle the first button\n\n  # add to the scene\n  scene.add(scene.radioGroup)\n  for btn in scene.radioButtons:\n    scene.add(btn)\n
\n\n\n

GUI: ProgressBar

\n
\n# somewhere in the initialization routine\n  scene.bar = newProgressBar((200, 50), 0xFF0000FF'u32, 0xFF0000FF'u32, myFont)\n  scene.bar.min = 0\n  scene.bar.max = 100\n  scene.bar.direction = Direction.leftRight\n  scene.bar.outline = (1, 1) # one pixel outline\n  scene.add(scene.bar)\n\n# on update\n  scene.bar.value = newValue\n
\n\n\n\n\n
\n\n \n
\n\n\n\n\n\n\n\n\n\n\n\n\n" }, { "path": "docs/structure.js", "content": "// STRUCTURE\n\n\n/**\n * Create favicon link tag.\n */\nfunction createFavicon() {\n var icon = document.createElement('link');\n icon.rel = 'shortcut icon';\n icon.href = 'favicon.ico';\n icon.type = \"image/x-icon\";\n document.querySelector('head').appendChild(icon);\n}\n\n\n/**\n * Create a header link object.\n *\n * @param name Link name (without extension).\n *\n * @param disabled If true - the link is disabled.\n *\n * @return an object with a link to the @param link.\n */\nfunction headerLink(name, disabled) {\n var a = document.createElement('a');\n if(disabled)\n a.classList.add('disabled');\n a.href = name + '.html';\n a.classList.add('menu');\n a.innerHTML = name.toUpperCase();\n var result = document.createElement('span');\n result.appendChild(a);\n return result;\n}\n\n\n/**\n * Fill the
of the current html-file.\n *\n * @param title Header title.\n *\n * @param logo Path to the logo image (without extension).\n */\nfunction createHeader(title, logo) {\n var img = document.createElement('img');\n img.src = logo + '.png';\n\n var logoLink = document.createElement('a');\n logoLink.href = 'index.html';\n logoLink.target = '_self';\n logoLink.appendChild(img);\n\n var logo = document.createElement('div');\n logo.classList.add('logo');\n logo.appendChild(logoLink);\n\n var headerTitle = document.createElement('h1');\n headerTitle.innerHTML = title;\n\n var headerLinks = [\n headerLink('index'),\n headerLink('demos'),\n headerLink('tutorials'),\n headerLink('snippets'),\n headerLink('docs'),\n headerLink('links'),\n ];\n\n var menu = document.createElement('div');\n for(var i = 0; i < headerLinks.length; i++) {\n menu.appendChild(headerLinks[i]);\n }\n\n var titleDiv = document.createElement('div');\n titleDiv.appendChild(headerTitle);\n titleDiv.appendChild(menu);\n\n var logoR = document.createElement('div');\n logoR.classList.add('logo');\n\n var headerDiv = document.createElement('div');\n headerDiv.appendChild(logo);\n headerDiv.appendChild(titleDiv);\n headerDiv.appendChild(logoR);\n\n var header = document.querySelector('header');\n header.appendChild(headerDiv);\n header.appendChild(document.createElement('hr'));\n}\n\n\n/**\n * Fill the