node-sdl

Minimal sdl bindings for maximum fun

  • 所有者: creationix/node-sdl
  • 平台:
  • 許可證: MIT License
  • 分類:
  • 主題:
  • 喜歡:
    0
      比較:

Github星跟蹤圖

node-sdl ( Simple DirectMedia Layer bindings for node.js )

0. Installation

Currently, installation is finicky and largely depends upon my specific system for now. A future release is planned to make this process better. If you want to get it working, you need to have the dylibs mentioned in bindings.gyp under /usr/local/lib. (this includes the main SDL2 dylib, SDL2_ttf, and SDl2_image)

If you have those libraries, and clone node-sdl, you can build it with

1. Usage

As a general rule, these bindings adhere to the following conventions.

  • SDL structs are wrapped at the base level of the bindings. If you want a Window, it will be under sdl.Window.
  • Structs that you would normally pass to various functions are instead wrapped as objects with prototype functions, and are created with the new keyword. As an example, instead of doing something such as sdl.GetWindowWidth(window), you would instead do var window = new sdl.Window(...); window.getWidth().
  • Constants, enums, etc. are split up into various namespaces below the base namespace, based on where the underscores are in their name. This roughly translates SDL_WINDOWPOS_CENTERED into sdl.WINDOWPOS.CENTERED.
  • Extensions to the base SDL API are under their own namespace. While you would find sdl.Window or sdl.Renderer, anything under the SDL_ttf library would be under sdl.TTF If you want to make a font, you would use new sdl.TTF.Font.

2. Specific usage

2.1 Initialization and Shutdown

Explaining the basics behind finding pieces of the SDL API is all well and good, but examples are still the best. So here is a quick and easy way to create a new window using node-sdl.

It's that easy. Though one thing to be aware of: in that example I declared a window in the global space. Because that is the only place it is referenced, once the script finishes (meaning after the call to setTimeout) there will be no more references to it. That means the window will get garbage collected sometime in the future. And because the bindings handle destroying SDL objects when the wrapping object gets destructed, that means the window will disappear, seemingly randomly. Make sure you keep a reference to all objects you want to persist somewhere, or you might find your window disappearing without warning.

2.2 Events

Currently, events are wrapped as a pure Javascript object. So trying to access properties of the event that don't exist for that event will give back undefined. You can determine the exact type of event by checking event.type just like in SDL. Same goes for all the other properties. If an event would have a key member, that will be in the Javascript object, etc.

3. License

Copyright (c) 2014 Tim "creationix" Caswell

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.

主要指標

概覽
名稱與所有者creationix/node-sdl
主編程語言C++
編程語言Python (語言數: 3)
平台
許可證MIT License
所有者活动
創建於2011-06-25 18:28:35
推送於2014-12-06 18:38:20
最后一次提交2014-12-06 13:38:20
發布數2
最新版本名稱v0.1.4 (發布於 )
第一版名稱v0.0.2 (發布於 )
用户参与
星數177
關注者數8
派生數43
提交數119
已啟用問題?
問題數17
打開的問題數8
拉請求數6
打開的拉請求數0
關閉的拉請求數1
项目设置
已啟用Wiki?
已存檔?
是復刻?
已鎖定?
是鏡像?
是私有?