SDL::Platform (3)

Leading comments

Automatically generated by Pod::Man 4.09 (Pod::Simple 3.35)

Standard preamble:
========================================================================

(The comments found at the beginning of the groff file "man3/SDL::Platform.3pm".)

NAME

SDL-Platform - Platform Specific Information about SDL Perl

CATEGORY

Documentation

DESCRIPTION

This document describes specific information regarding the installation and use of .

General (all

OS

)

You need to install Alien::SDL to acquire all prerequisites of .

On Windows, Alien::SDL will get you zip-files containing prebuilt libs.

On Unixes you can choose between compiling libs or use libs provided by the dist. The different options on Unixes are available when requirements are met. Like having specific libs installed.

There is some additional documentation in the Github-Wiki <github.com/PerlGameDev/SDL/wiki/Testing>. You definitively want to look there, if you want to know how to install

from the latest sources (e.g. in an unfinished, unreleased state).

Windows

Installation

We recommend Strawberry Perl. You can get it here <strawberryperl.com>.

Once you installed Strawberry Perl, you can access the cpan shell via the start menu.

Open up the cpan shell and type "install Alien::SDL SDL". Please follow the dialog and answer the questions to the best of your knowledge.

Mac OS X

Installation

You will need a newer version of Perl that you can install with App::perlbrew.

Once you have a newer Perl installed please use "cpan" to install Alien::SDL (and of course

).

Using

SDL

on Mac

OS X

You can't use the "perl" executable to run scripts on Mac you need to use "SDLPerl". When you install , a program named "SDLPerl" is installed. It should be in your path.

Using Mac

your Perl script have to look like this:

  #!SDLPerl
  
  use strict;
  use warnings;
  use SDL;
  # your code here ...

Using the wrong Perl executable, you might encounter a lot of error messages resulting in "terminate called after throwing an instance of 'NSException'". cf. the corresponding github issue <github.com/PerlGameDev/SDL/issues/208>.

SEE ALSO

*

Alien::SDL

*

SDL

AUTHORS

See list of module authors in .

If you would like to contribute to

Perl, please post a message on the mailing list:

sdl-devel@perl.org

And request access to the github repository. Or drop us a line on #sdl over at irc.perl.org

COPYRIGHT & LICENSE

Copyright 2002-2010 Authors as listed above, all rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

DISCLAIMER OF WARRANTY

(),