Allegro 5.0.7 template for Xcode 4 Files

Allegro 5.0.7 template for Xcode 4
==================================


Install
=======

Place this template in ~/Library/Developer/Xcode/Templates

If any of the above folders don't exist, create them. Xcode will find it.

Make sure that your Allegro frameworks are installed and located at /Library/Frameworks.

Start a new project, and if everything went well you will see a Templates section, 
select the Allegro Application template to start coding.


Notes
=====

The following conditions are required in order for this template to work:
- You need to have already installed the Allegro 5.0.7 frameworks
- This template is meant for Xcode 4 and was tested in Xcode 4.4
- You may need to change the Base SDK. This is set up to use OS X 10.8.


Allegro Frameworks
==================

Just in case you haven't installed the Allegro Frameworks, please refer to:
http://wiki.allegro.cc/index.php?title=OSX,_Xcode_4,_Framework
  (remember to turn frameworks on when you reach to cmake, also explained in above link)

In summary:

CMAKE
- Download CMake from http://www.cmake.org/cmake/resources/software.html
    (Recommended 2.8.8 or better to avoid possible conflicts with OSX)
- Remember to select "Install Command Line Links" at the end of installation.

TTFs | FreeType
- If you are interested in using TTFs (True Type Fonts) and you haven't already 
  installed it, you can install FreeType from https://sourceforge.net/projects/freetype/
- Download, extract, open terminal
- cd to extracted directory ($ cd freetype-x.x.xx)
     or type 'cd ' w/o quotes and drag extracted folder to terminal, press enter
- Type:
	
	./configure
	make
	sudo make install

Allegro & Frameworks
- Open terminal and input these lines:

	svn checkout https://alleg.svn.sourceforge.net/svnroot/alleg/allegro/branches/5.0 allegro
	cd allegro
	mkdir build
	cd build
	cmake -DWANT_FRAMEWORKS=1 ..
	make
	sudo make install


Some Features
=============

- I've added options upon creating the project to link with Allegro Audio, Codecs, Color, 
  Dialog, Font, Image, Memfile, Primitives & TTF.
- If you need any of them in your project, just make sure they are in /Library/Frameworks 
  and click the checkbox in the new project dialog.
- Nothing else is required to make this work except maybe changing your Base SDK.
- Starts you off with a window that will stay open for 10 seconds letting you know 
  it is working.
- Completely gets rid of the messy manual setup I'm sure you've gone through if you've 
  used Allegro on a mac before.


Licensing
=========

Use at free will but give me credit.


Special Thanks
==============

Special thanks to gm-dog-72 for his SDL Template for Xcode 4 which served as a base 
for the Allegro template (https://sourceforge.net/projects/sdltemplateforx/).