Archive for docs

Every thing you always wanted to know about the Nifty screen-Tag

// August 19th, 2010 // No Comments » // docs

You want to use the ESC key to skip a Nifty screen?
You need to handle a keyboard event for the whole screen and not just when a single element has the keyboard focus?
Or do you need to change the default focus element for a Nifty screen?

Look no further!

The Nifty GUI Wiki has been updated and the <screen> Tag and all of its attributes have been explained and documented!

You can find the reference here: http://sourceforge.net/apps/mediawiki/nifty-gui/index.php?title=Elements

Have fun,
void :)

Nightly Builds Available

// May 14th, 2010 // No Comments » // bubble, docs

Nifty will now build each midnight automatically. Well, at least when this computer here is running at this time which, erm, should be often :)

Hudson will svn checkout all relevant nifty projects and will then “mvn clean deploy” them to the nifty maven repository at sf.net. This means that all projects that are already being build with maven and have this in their pom.xml:

<repositories>
    <repository>
      <id>nifty-maven-repo.sourceforge.net</id>
      <url>http://nifty-gui.sourceforge.net/nifty-maven-repo</url>
    </repository>
</repositories>

will automatically get the latest nifty builds!

Currently this means 1.2-SNAPSHOT for Nifty as well as the Nifty Default Controls and the black Style projects and 1.0-SNAPSHOT for the new Nifty Renderer Projects.

Currently the following projects are build each night.

Nifty
http://nifty-gui.sourceforge.net/nifty-maven-repo/lessvoid/nifty/
http://nifty-gui.sourceforge.net/nifty-maven-repo/lessvoid/nifty-default-controls/
http://nifty-gui.sourceforge.net/nifty-maven-repo/lessvoid/nifty-style-black/

Nifty Renderer
http://nifty-gui.sourceforge.net/nifty-maven-repo/lessvoid/nifty-lwjgl-slick-renderer/
http://nifty-gui.sourceforge.net/nifty-maven-repo/lessvoid/nifty-lwjgl-renderer/
http://nifty-gui.sourceforge.net/nifty-maven-repo/lessvoid/nifty-slick-renderer/
http://nifty-gui.sourceforge.net/nifty-maven-repo/lessvoid/nifty-java2d-renderer/

The JME2 Renderer currently has some weird problems being automatically build. So this is not yet available – still working on it:
http://nifty-gui.sourceforge.net/nifty-maven-repo/lessvoid/nifty-jme-renderer/

If you’re not using Maven you should still be able to get the SNAPSHOT jars from the URLs mentioned above. Just find the sub directory 1.2-SNAPSHOT or 1.0-SNAPSHOT and get the latest JAR from there. Don’t mind the name of the jar tho. It’s automatically generated by Maven and it’s just named with the build date and time.

Good luck!
void

Nifty plays well with others and of course with slick2d too

// September 13th, 2009 // 2 Comments » // design, docs

Nifty can be used as a standalone GUI. So when your game enters its menu or option screens Nifty is all there is on the screen and all user input is handled by Nifty.

When using Nifty together with Slick2d this is represented by the NiftyGameState class. Using this class your Slick2d StateBasedGame can easliy switch from your in game state to the NiftyGameState and display the GUI.

But this is not the only way Nifty can be used. You can easily use Nifty to render your in-game GUI too! Nifty plays well with others (as long as they use OpenGL/lwjgl for rendering that is).

It’s not complicated at all and I wanted to write example code that demonstrates how easy it is for a long time. Motivated by a question at the Nifty Forum at souceforge.net I did now :)

What’s demonstrated in the new slick example is, how you can use Nifty to render a GUI on top of a normal slick GameState.

Here is a screenshot of the example which renderes Text from within Slick that changes color when you press the keys 1-3. On top of this it renders a Nifty GUI that responds to mouse events. Additionally if you press 1-3 the colored Nifty boxes start to shake :D

Slick Overlay with Nifty GUI

Slick Overlay with Nifty GUI

You can try it out with the Webstart:

http://nifty-gui.sourceforge.net/webstart/nifty-slick-overlay-demo.jnlp

and you can find the example in svn or you can browse it online here:

http://nifty-gui.svn.sourceforge.net/viewvc/nifty-gui/nifty-examples/trunk/src/main/java/de/lessvoid/nifty/examples/slick/niftyoverlay/ (Java classes)

http://nifty-gui.svn.sourceforge.net/viewvc/nifty-gui/nifty-examples/trunk/src/main/resources/slick/niftyoverlay/overlay.xml?revision=534&view=markup (Nifty XML for the Screen – overlay.xml)

Keep reading the full Article to see the details on how we get this to work and what you need to consider.

(more…)

Nifty Sourceforge.net Updates

// April 4th, 2009 // 1 Comment » // docs

We’ve added a new Wikipage that gives an Introduction to the Nifty Style System:

Effect Tutorial/Introduction

It’s not completly finished yet but should give you some more informations about effects in Nifty.

Additionally we’ve removed the old Screenshots Page from the sf.net Nifty project website and enabled the much cooler gallery feature. And there is now a sf.net standard forum enabled for the Nifty project too:

Nifty Gallery at Sourceforge

Nifty Forum at Sourceforge

Have fun,
void =)

wiki updated

// March 14th, 2009 // No Comments » // docs

Adding Documentation on how and where to “svn checkout” Nifty and how to build it with Maven:

Building Nifty from Source Wiki Page

:D

Updated Slick and Lwjgl Library Versions + More Maven Love

// March 14th, 2009 // No Comments » // bubble, docs

I’ve now updated the Nifty Dependencies in SVN (for the Nifty 1.0 Release) to the following Versions:

  • Slick #239
  • Lwjgl 2.0.1

Besides that I realized that I’ve already had setup a Nifty Maven Repository at Sourceforge. This was meant to store Nifty releases to allow other Projects that use Maven and Nifty to easily access the Nifty libs. So for instance you just need to add:

<repositories>
  <repository>
    <id>nifty-maven-repo.sourceforge.net</id>
    <url>http://nifty-gui.sourceforge.net/nifty-maven-repo</url>
  </repository>
</repositories>

to your applications pom.xml and it will automatically find the Nifty dependency :) So far so good.

BUT

Today I realized that I could use the same approach to get Lwjgl and Slick2D easily under Maven control. So when switching the Versions to Slick #239 und Lwjgl 2.0.1 I deployed both libs to the Nifty Maven Repo at Sourceforge! :D

So what does this mean for you?

It means just one thing. It’s now easier then ever to build Nifty! Just “svn co” it from Sourceforge and execute “mvn package” and it should automatically download all required libs without any changes!

Nifty! :D

Effects Reference added to Wiki

// February 15th, 2009 // No Comments » // docs

A Nifty Effects Reference Page has been added to the Nifty Gui Wiki at sourceforge.net :) It’s still work in progress but it already lists all standard effects that are available and it documents all of the standard parameters that are available.

void

How to use the Drop Down Control

// December 7th, 2008 // No Comments » // docs

Nifty 0.0.5 adds support for a Drop Down Control. Here we show how to actually use it.

XML

First of all you need to add the standard Nifty controls to your xml. To keep things easy for the moment we use the default Nifty styles too.

<!-- load default styles and controls -->

So adding a Drop Down Control works like adding any other control:

Basically you address the control you want to add, in this case it’s “dropDownControl”. And you need to give your control an id too, so that you can reference it later (“dropDown1″).

(more…)

Create your own Nifty Panel Styles – it’s easy! :D

// November 8th, 2008 // No Comments » // docs

To customize and extend the default nifty styles is easy. In this example you add your own panel style :)

Default Styles
Nifty default styles need to be included using the <useStyle> tag:

 <!-- include the default styles-->

To actual use this Style for a panel you use the “style” Attribute in the <panel> tag:

 <!-- panel with "nifty-panel" style -->

When you’re using the two (!) lines you’ll get the well known default “yellow, red, black” colored panel:

default panel style

default panel style

(more…)