vlc/libvlc.h: Use libvlc_time_t.
[vlc.git] / extras / MacOSX / Framework / Headers / Public / VLCMediaPlayer.h
1 /*****************************************************************************
2  * VLCMediaPlayer.h: VLC.framework VLCMediaPlayer header
3  *****************************************************************************
4  * Copyright (C) 2007 Pierre d'Herbemont
5  * Copyright (C) 2007 the VideoLAN team
6  * $Id$
7  *
8  * Authors: Pierre d'Herbemont <pdherbemont # videolan.org>
9  *
10  * This program is free software; you can redistribute it and/or modify
11  * it under the terms of the GNU General Public License as published by
12  * the Free Software Foundation; either version 2 of the License, or
13  * (at your option) any later version.
14  *
15  * This program is distributed in the hope that it will be useful,
16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
18  * GNU General Public License for more details.
19  *
20  * You should have received a copy of the GNU General Public License
21  * along with this program; if not, write to the Free Software
22  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
23  *****************************************************************************/
24
25 #import <Cocoa/Cocoa.h>
26 #import "VLCMedia.h"
27 #import "VLCVideoView.h"
28 #import "VLCVideoLayer.h"
29 #import "VLCTime.h"
30
31 /* Notification Messages */
32 extern NSString * VLCMediaPlayerTimeChanged;
33 extern NSString * VLCMediaPlayerStateChanged;
34
35 /**
36  * TODO: Documentation VLCMediaPlayerState
37  */
38 typedef enum VLCMediaPlayerState
39 {
40     VLCMediaPlayerStateStopped,        //< Player has stopped
41     VLCMediaPlayerStateOpening,        //< Stream is opening
42     VLCMediaPlayerStateBuffering,      //< Stream is buffering
43     VLCMediaPlayerStateEnded,          //< Stream has ended
44     VLCMediaPlayerStateError,          //< Player has generated an error
45     VLCMediaPlayerStatePlaying,        //< Stream is playing
46     VLCMediaPlayerStatePaused          //< Stream is paused
47 } VLCMediaPlayerState;
48
49 /**
50  * TODO: Documentation extern NSString * VLCMediaPlayerStateToString(VLCMediaPlayerState)
51  */
52 extern NSString * VLCMediaPlayerStateToString(VLCMediaPlayerState state);
53
54 /**
55  * Formal protocol declaration for playback delegates.  Allows playback messages
56  * to be trapped by delegated objects.
57  */
58 @protocol VLCMediaPlayerDelegate
59 /**
60  * TODO: Documentation - [VLCMediaPlayerDelegate ]
61  */
62 - (void)mediaPlayerTimeChanged:(NSNotification *)aNotification;
63
64 /**
65  * TODO: Documentation - [VLCMediaPlayerDelegate ]
66  */
67 - (void)mediaPlayerStateChanged:(NSNotification *)aNotification;
68 @end
69
70 // TODO: Should we use medialist_player or our own flavor of media player?
71 @interface VLCMediaPlayer : NSObject 
72 {
73     id delegate;                        //< Object delegate
74
75     void * instance;                    //  Internal
76     VLCMedia * media;                   //< Current media being played
77     VLCTime * cachedTime;
78     VLCMediaPlayerState cachedState;
79     float position;
80 }
81
82 /* Initializers */
83 - (id)initWithVideoView:(VLCVideoView *)aVideoView;
84 - (id)initWithVideoLayer:(VLCVideoLayer *)aVideoLayer;
85
86 /* Properties */
87 - (void)setDelegate:(id)value;
88 - (id)delegate;
89
90 /* Video View Options */
91 // TODO: Should be it's own object?
92
93 - (void)setVideoView:(VLCVideoView *)aVideoView;
94 - (void)setVideoLayer:(VLCVideoLayer *)aVideoLayer;
95
96 - (void)setVideoAspectRatio:(char *)value;
97 - (char *)videoAspectRatio;
98 - (void)setVideoSubTitles:(int)value;
99 - (int)videoSubTitles;
100
101 - (void)setVideoCropGeometry:(char *)value;
102 - (char *)videoCropGeometry;
103
104 - (void)setVideoTeleText:(int)value;
105 - (int)videoTeleText;
106
107 - (void)setRate:(int)value;
108 - (int)rate;
109
110 /* Video Information */
111 - (NSSize)videoSize;
112 - (BOOL)hasVideoOut;
113 - (float)framesPerSecond;
114
115 /**
116  * Sets the current position (or time) of the feed.
117  * \param value New time to set the current position to.  If time is [VLCTime nullTime], 0 is assumed.
118  */
119 - (void)setTime:(VLCTime *)value;
120
121 /** 
122  * Returns the current position (or time) of the feed.
123  * \return VLCTIme object with current time.
124  */
125 - (VLCTime *)time;
126
127 - (void)setChapter:(int)value;
128 - (int)chapter;
129 - (int)countOfChapters;
130
131 /* Audio Options */
132 - (void)setAudioTrack:(int)value;
133 - (int)audioTrack;
134 - (int)countOfAudioTracks;
135
136 - (void)setAudioChannel:(int)value;
137 - (int)audioChannel;
138
139 /* Media Options */
140 - (void)setMedia:(VLCMedia *)value;
141 - (VLCMedia *)media;
142
143 /* Playback Operations */
144 /**
145  * Plays a media resource using the currently selected media controller (or 
146  * default controller.  If feed was paused then the feed resumes at the position 
147  * it was paused in.
148  * \return A Boolean determining whether the stream was played or not.
149  */
150 - (BOOL)play;
151
152 /**
153  * Toggle's the pause state of the feed.
154  */
155 - (void)pause;
156
157 /**
158  * Fast forwards through the feed at the standard 1x rate.
159  */
160 //- (void)fastForward;
161
162 /**
163  * Fast forwards through the feed at the rate specified.
164  * \param rate Rate at which the feed should be fast forwarded.
165  */
166 //- (void)fastForwardAtRate:(int)rate;
167
168 /**
169  * Rewinds through the feed at the standard 1x rate.
170  */
171 //- (void)rewind;
172
173 /**
174  * Rewinds through the feed at the rate specified.
175  * \param rate Rate at which the feed should be fast rewound.
176  */
177 //- (void)rewindAtRate:(int)rate;
178
179 /* Playback Information */
180 /**
181  * Playback state flag identifying that the stream is currently playing.
182  * \return TRUE if the feed is playing, FALSE if otherwise.
183  */
184 - (BOOL)isPlaying;
185
186 /**
187  * Playback state flag identifying wheather the stream will play.
188  * \return TRUE if the feed is ready for playback, FALSE if otherwise.
189  */
190 - (BOOL)willPlay;
191
192 /**
193  * Playback's current state.
194  * \see VLCMediaState
195  */
196 - (VLCMediaPlayerState)state;
197
198 /**
199  * Returns the receiver's position in the reading. 
200  * \return A number between 0 and 1. indicating the position
201  */
202 - (float)position;
203 - (void)setPosition:(float)newPosition;
204
205 - (BOOL)isSeekable;
206
207 @end