I'll explain basically what CMAKE is.
The reason you did not need to use CMAKE for Allegro is that you used pre compiled binaries. Once you have the lib file, which you do because you're using precompiled binaries, you just need to tell MSVC where everything is. (I'll get to that).
What CMAKE does is it runs a script, usually CMakeLists.txt. This script lets you choose certain things, like in Allegro, you can choose to have the examples or not. Then it will generate the appropriate project file for you. A vcprojx or something. On Mac it can make you an XCode project.
So for Agui, get CMake for Windows http://www.cmake.org/
Next you'll need a tool called TortoiseSVN http://tortoisesvn.net/
get and install both of these.
Next, make a folder anywhere you like called agui_svn.
Right click it and click SVN Checkout. Then in the URL of Repository TextField enter
What you just did is download the latest revision of the Agui source code.
Next you need to compile that source code and generate the lib file.
In agui_svn/trunk create a new folder called MSVC.
Notice the CMakeLists.txt in the trunk folder.
Open up CMAKE.
For the source folder, point it to agui_svn/trunk
Where to build, point it to agui_svn/trunk/MSVC
Click Configure. You'll be given a list of options. Select Visual Studio 2010 if it's not already selected.
Let it do its thing.
You now have the option to not compile the allegro backend or to build agui as a DLL. I highly advise AGAINST building it as a DLL.
Leave the default options.
Click Generate, and then go to your MSVC directory.
There's files in there now
Open the agui sln (solution)
This is where things get a bit tricky. I'll try not to overcomplicated this.
You basically have 2 types of compilations. Debug, and Release.
Within those, you can build with what is called MT or MD. MT is if your library links to the runtime library (the thing that has std vector, strlen, malloc, etc) or not.
It is important that you build it in accordance to your project preferences.
To check this, in your game project, right click your project in solution explorer in msvc, click properties, under C/C++, click Code Generation.
You'll see something like Multithreaded DLL.
You need to do the same thing for Agui and Agui_Allegro5 projects and make sure it is the same as your game project.
All that's left is to decide debug or release.
Right click the solution this time in solution explorer and click properties.
Click Configuration to your left. You'll see 4 projects all on Debug.
When you're ready for the release compile, go here and change them all to release with debug info.
For both Debug and Release with debug info, click build in the menu bar and select rebuild solution.
Agui expects to find Allegro5 installed (in your include paths), which should not be a problem, but if it is you'll get lots of errors.
To add your include files and lib files you'll need to go and do this:
To specify a per-user directory list
On the View menu, click Property Manager.
In Property Manager, click a configuration-and-platform node; for example, Debug | Win32.
The node expands and displays a user property sheet such as Microsoft.Cpp.<platform>.user, where <platform> is a system-defined value such as Win32 or X64. The <platform> value and the platform for the project must be the same.
Either double-click the user property sheet, or click the user property sheet and then click Properties in the shortcut menu.
The <User Property Sheet> Property Pages dialog box is displayed, and the VC++ Directories node is highlighted.
Edit the directory lists, as described earlier in step 3 of "To specify a project directory list".
So in there you can add include and lib directories.
Lets discard that for a second and put some files in there place.
I do not know how or where you store your libraries so try to adapt the following to your needs.
I set up my libraries like this.
Create a folder c:/lib
Add folders include and lib to c:/lib
In the agui_svn/trunk/include folder, copy the Agui folder to c:/lib/include
Now navigate to agui_svn/trunk/MSVC/Debug
rename agui.lib and agui_allegro5.lib to agui_d.lib and agui_allegro5_d.lib
move these to c:/lib/lib
Now head to the Release With Debug Info folder in MSVC (or whatever it is called) and copy the agui and agui_allegro5 libs to the same folder.
Now, getting back to those property pages and include directories.
Add c:/lib/include to your include directories and c:/lib/lib to your Library directories.
Now open your project, right click its name in solution explorer, for both Debug and Release, you'll need to navigate to linker->input and add agui.lib and agui_allegro5.lib to your additional dependencies.
After that, try to compile my agui example.