node-sdl

Minimal sdl bindings for maximum fun

  • Owner: creationix/node-sdl
  • Platform:
  • License:: MIT License
  • Category::
  • Topic:
  • Like:
    0
      Compare:

Github stars Tracking Chart

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.

Main metrics

Overview
Name With Ownercreationix/node-sdl
Primary LanguageC++
Program languagePython (Language Count: 3)
Platform
License:MIT License
所有者活动
Created At2011-06-25 18:28:35
Pushed At2014-12-06 18:38:20
Last Commit At2014-12-06 13:38:20
Release Count2
Last Release Namev0.1.4 (Posted on )
First Release Namev0.0.2 (Posted on )
用户参与
Stargazers Count177
Watchers Count8
Fork Count43
Commits Count119
Has Issues Enabled
Issues Count17
Issue Open Count8
Pull Requests Count6
Pull Requests Open Count0
Pull Requests Close Count1
项目设置
Has Wiki Enabled
Is Archived
Is Fork
Is Locked
Is Mirror
Is Private