View source for VLCKit

== How to build the framework ==

* '''get the [[Git|VLC Source Code from Git]]''': 
 $ git clone git://git.videolan.org/vlc.git

* '''build the core components''': 

 $ cd extras/contrib
 $ ./bootstrap
 $ make
 $ cd ../..
 $ ./bootstrap
 $ export CC=/Developer/usr/bin/llvm-gcc-4.2
 $ export CXX=/Developer/usr/bin/llvm-g++-4.2
 $ export OBJC=/Developer/usr/bin/llvm-gcc-4.2
 $ ./configure 
 $ make

If the second make fails, giving you an error like:

    ld warning: in ///Users/username/dev/vlc/extras/contrib/lib/libx264.a, file is not of required architecture
    Undefined symbols:
       "_x264_encoder_close", referenced from:
       _Close in libx264_plugin_la-x264.o
    etc...

then download and build x264. Then copy libx264.a into vlc/extras/contrib/lib/

* '''On Snow Leopard some additional flags are required to build a 32-bit copy'''
 $ cd extras/contrib
 $ ./bootstrap
 $ make
 $ cd ../..
 $ ./bootstrap
 $ export CC=/Developer/usr/bin/llvm-gcc-4.2
 $ export CXX=/Developer/usr/bin/llvm-g++-4.2
 $ export OBJC=/Developer/usr/bin/llvm-gcc-4.2
 $ export CFLAGS="-arch i386 -m32"
 $ export CXXFLAGS="-arch i386 -m32"
 $ export OBJCFLAGS="-arch i386 -m32"
 $ export LDFLAGS="-arch i386"
 $ ./configure 
 $ make

* '''build the framework''': 
** open projects/macosx/framework/VLCKit.xcodeproj 
** make sure the VLCKit target is selected 
** hit build

== Basic usage in your application ==
The code should speak by itself
   // Set up a videoView by hand. You can also do that in the nib file
    videoView = [[VLCVideoView alloc] initWithFrame:[[window contentView] bounds]];
    [[window contentView] addSubview:videoView];
    [videoView setAutoresizingMask: NSViewHeightSizable|NSViewWidthSizable];
   
    // Init the player object
    player = [[VLCMediaPlayer alloc] initWithVideoView:videoView];
  
    [player setMedia:[VLCMedia mediaWithPath:@"/to/my/movie"]];
    [player play];

== Sample code ==
You should be able to find sample code in:
* Framework/Examples: This is the folder that contains the VLC.framework basics usage.

* vlc-trunk/extras/MacOSX/VLC_app: This is the VLC application that uses the framework intensivly, this is much more advanced.