69f591b77dabe68882742e11bc78f05805f8bcce
[vlc.git] / bindings / java / core / src / main / java / org / videolan / jvlc / internal / LibVlc.java
1 /*****************************************************************************
2  * LibVlc.java: VLC Java Bindings JNA Glue
3  *****************************************************************************
4  * Copyright (C) 1998-2008 the VideoLAN team
5  *
6  * Authors: Filippo Carone <filippo@carone.org>
7  *
8  *
9  * $Id $
10  *
11  * This program is free software; you can redistribute it and/or modify
12  * it under the terms of the GNU General Public License as published by
13  * the Free Software Foundation; either version 2 of the License, or
14  * (at your option) any later version.
15  *
16  * This program is distributed in the hope that it will be useful,
17  * but WITHOUT ANY WARRANTY; without even the implied warranty of
18  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
19  * GNU General Public License for more details.
20  *
21  * You should have received a copy of the GNU General Public License
22  * along with this program; if not, write to the Free Software
23  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111, USA.
24  *****************************************************************************/
25
26 package org.videolan.jvlc.internal;
27
28 import java.util.HashMap;
29 import java.util.Map;
30
31 import com.sun.jna.Callback;
32 import com.sun.jna.Library;
33 import com.sun.jna.Native;
34 import com.sun.jna.NativeLong;
35 import com.sun.jna.Platform;
36 import com.sun.jna.Pointer;
37 import com.sun.jna.PointerType;
38 import com.sun.jna.Structure;
39 import com.sun.jna.Union;
40 import com.sun.jna.win32.W32APIFunctionMapper;
41 import com.sun.jna.win32.W32APITypeMapper;
42
43
44 public interface LibVlc extends Library
45 {
46     Map options = new HashMap() {
47         {
48             put(Library.OPTION_DLOPEN_GLOBAL, Boolean.TRUE);
49         }
50     };
51     
52     LibVlc INSTANCE = (LibVlc) Native.loadLibrary(Platform.isWindows()? "libvlc" : "vlc", LibVlc.class, options);
53
54     LibVlc SYNC_INSTANCE = (LibVlc) Native.synchronizedLibrary(INSTANCE);
55     
56     public static class libvlc_exception_t extends Structure
57     {
58
59         public int raised;
60
61         public int code;
62
63         public String message;
64     }
65
66     public static class libvlc_log_message_t extends Structure
67     {
68
69         public int sizeof_msg; /* sizeof() of message structure, must be filled in by user */
70
71         public int i_severity; /* 0=INFO, 1=ERR, 2=WARN, 3=DBG */
72
73         public String psz_type; /* module type */
74
75         public String psz_name; /* module name */
76
77         public String psz_header; /* optional header */
78
79         public String psz_message; /* message */
80     }
81
82     public static class libvlc_event_t extends Structure
83     {
84
85         public int type;
86
87         public Pointer obj;
88
89         public event_type_specific event_type_specific;
90
91     }
92
93     public class media_meta_changed extends Structure
94     {
95
96         public Pointer meta_type;
97     }
98
99     public class media_subitem_added extends Structure
100     {
101
102         public LibVlcMediaDescriptor new_child;
103     }
104
105     public class media_duration_changed extends Structure
106     {
107
108         public NativeLong new_duration;
109     }
110
111     public class media_preparsed_changed extends Structure
112     {
113
114         public int new_status;
115     }
116
117     public class media_freed extends Structure
118     {
119
120         public LibVlcMediaDescriptor md;
121     }
122
123     public class media_state_changed extends Structure
124     {
125
126         // @todo: check this one
127         public int new_state;
128     }
129
130     /* media instance */
131
132     public class media_player_position_changed extends Structure
133     {
134
135         public float new_position;
136     }
137
138     public class media_player_time_changed extends Structure
139     {
140
141         // @todo: check this one
142         public long new_time;
143     }
144
145     /* media list */
146     public class media_list_item_added extends Structure
147     {
148
149         public LibVlcMediaDescriptor item;
150
151         public int index;
152     }
153
154     public class media_list_will_add_item extends Structure
155     {
156
157         public LibVlcMediaDescriptor item;
158
159         public int index;
160     }
161
162     public class media_list_item_deleted extends Structure
163     {
164
165         public LibVlcMediaDescriptor item;
166
167         public int index;
168     }
169
170     public class media_list_will_delete_item extends Structure
171     {
172
173         public LibVlcMediaDescriptor item;
174
175         public int index;
176     }
177
178     /* media list view */
179     public class media_list_view_item_added extends Structure
180     {
181
182         public LibVlcMediaDescriptor item;
183
184         public int index;
185     }
186
187     public class media_list_view_will_add_item extends Structure
188     {
189
190         public LibVlcMediaDescriptor item;
191
192         public int index;
193     }
194
195     public class media_list_view_item_deleted extends Structure
196     {
197
198         public LibVlcMediaDescriptor item;
199
200         public int index;
201     }
202
203     public class media_list_view_will_delete_item extends Structure
204     {
205
206         public LibVlcMediaDescriptor item;
207
208         public int index;
209     }
210
211     /* media discoverer */
212     public class media_media_discoverer_started extends Structure
213     {
214
215         public Pointer unused;
216     }
217
218     public class media_media_discoverer_ended extends Structure
219     {
220
221         public Pointer unused;
222     }
223
224     public class event_type_specific extends Union
225     {
226
227         public media_meta_changed media_meta_changed;
228
229         public media_subitem_added media_subitem_added;
230
231         public media_duration_changed media_duration_changed;
232
233         public media_preparsed_changed media_preparsed_changed;
234
235         public media_freed media_freed;
236
237         public media_state_changed media_state_changed;
238
239         public media_player_position_changed media_player_position_changed;
240
241         public media_player_time_changed media_player_time_changed;
242
243         public media_list_item_added media_list_item_added;
244
245         public media_list_will_add_item media_list_will_add_item;
246
247         public media_list_item_deleted media_list_item_deleted;
248
249         public media_list_will_delete_item media_list_will_delete_item;
250
251         public media_list_view_item_added media_list_view_item_added;
252
253         public media_list_view_will_add_item media_list_view_will_add_item;
254
255         public media_list_view_item_deleted media_list_view_item_deleted;
256
257         public media_list_view_will_delete_item media_list_view_will_delete_item;
258     }
259
260     public class LibVlcInstance extends PointerType
261     {
262     }
263
264     public class LibVlcMediaDescriptor extends PointerType
265     {
266     }
267
268     public class LibVlcMediaInstance extends PointerType
269     {
270     }
271
272     public class LibVlcMediaList extends PointerType
273     {
274     }
275
276     public class LibVlcMediaListPlayer extends PointerType
277     {
278     }
279
280     public class LibVlcEventManager extends PointerType
281     {
282     }
283
284     public class LibVlcLog extends PointerType
285     {
286     }
287
288     public class LibVlcLogIterator extends PointerType
289     {
290     }
291
292     // exception handling
293     void libvlc_exception_init(libvlc_exception_t exception);
294
295     int libvlc_exception_raised(final libvlc_exception_t exception);
296
297     void libvlc_exception_raise(libvlc_exception_t exception, String format, Object... args);
298
299     void libvlc_exception_clear(libvlc_exception_t exception);
300
301     String libvlc_exception_get_message(libvlc_exception_t exception);
302
303     // core
304     LibVlcInstance libvlc_new(int argc, String[] argv, libvlc_exception_t exception);
305
306     void libvlc_release(LibVlcInstance libvlc_instance_t);
307     
308     String libvlc_get_version();
309     
310     String libvlc_get_compiler();
311     
312     String libvlc_get_changeset();
313
314     // video
315
316     void libvlc_video_set_parent(LibVlcInstance libvlc_instance, long drawable, libvlc_exception_t exception);
317
318     void libvlc_toggle_fullscreen(LibVlcMediaInstance libvlc_instance);
319
320     void libvlc_set_fullscreen(LibVlcMediaInstance instance, int fullscreen, libvlc_exception_t exception);
321
322     int libvlc_get_fullscreen(LibVlcMediaInstance instance, libvlc_exception_t exception);
323
324     int libvlc_video_get_height(LibVlcMediaInstance instance, libvlc_exception_t exception);
325
326     int libvlc_video_get_width(LibVlcMediaInstance instance, libvlc_exception_t exception);
327
328     String libvlc_video_get_aspect_ration(LibVlcMediaInstance instance, libvlc_exception_t exception);
329
330     void libvlc_video_set_aspect_ration(LibVlcMediaInstance instance, String ratio, libvlc_exception_t exception);
331
332     int libvlc_video_get_spu(LibVlcMediaInstance instance, libvlc_exception_t exception);
333
334     int libvlc_video_set_spu(LibVlcMediaInstance instance, int spu, libvlc_exception_t exception);
335
336     String libvlc_video_get_crop_geometry(LibVlcMediaInstance instance, libvlc_exception_t exception);
337
338     void libvlc_video_set_crop_geometry(LibVlcMediaInstance instance, String geometry, libvlc_exception_t exception);
339
340     void libvlc_video_take_snapshot(LibVlcMediaInstance instance, String filename, int width, int height,
341         libvlc_exception_t exception);
342
343     void libvlc_video_destroy(LibVlcMediaInstance instance, libvlc_exception_t exception);
344
345     void libvlc_video_resize(LibVlcMediaInstance instance, int width, int height, libvlc_exception_t exception);
346
347     void libvlc_video_reparent(LibVlcMediaInstance instance, long drawable, libvlc_exception_t exception);
348
349     void libvlc_video_set_size(LibVlcInstance instance, int width, int height, libvlc_exception_t exception);
350
351     // audio
352
353     void libvlc_audio_toggle_mute(LibVlcInstance instance, libvlc_exception_t exception);
354
355     void libvlc_audio_set_mute(LibVlcInstance instance, int mute, libvlc_exception_t exception);
356
357     int libvlc_audio_get_mute(LibVlcInstance instance, libvlc_exception_t exception);
358
359     int libvlc_audio_get_volume(LibVlcInstance instance, libvlc_exception_t exception);
360
361     int libvlc_audio_set_volume(LibVlcInstance instance, int volume, libvlc_exception_t exception);
362
363     int libvlc_audio_get_track_count(LibVlcMediaInstance mediaInstance, libvlc_exception_t exception);
364
365     int libvlc_audio_get_track(LibVlcMediaInstance mediaInstance, libvlc_exception_t exception);
366
367     void libvlc_audio_set_track(LibVlcMediaInstance mediaInstance, int channel, libvlc_exception_t exception);
368
369     int libvlc_audio_get_channel(LibVlcInstance instance, libvlc_exception_t exception);
370
371     void libvlc_audio_set_channel(LibVlcInstance instance, int channel, libvlc_exception_t exception);
372
373     // playlist
374
375     void libvlc_playlist_loop(LibVlcInstance instance, int loop, libvlc_exception_t exception);
376
377     void libvlc_playlist_play(LibVlcInstance instance, int itemIndex, int optionsCount, String[] options,
378         libvlc_exception_t exception);
379
380     void libvlc_playlist_pause(LibVlcInstance instance, libvlc_exception_t exception);
381
382     void libvlc_playlist_stop(LibVlcInstance instance, libvlc_exception_t exception);
383
384     int libvlc_playlist_isplaying(LibVlcInstance instance, libvlc_exception_t exception);
385
386     int libvlc_playlist_items_count(LibVlcInstance instance, libvlc_exception_t exception);
387
388     void libvlc_playlist_next(LibVlcInstance instance, libvlc_exception_t exception);
389
390     void libvlc_playlist_prev(LibVlcInstance instance, libvlc_exception_t exception);
391
392     void libvlc_playlist_clear(LibVlcInstance instance, libvlc_exception_t exception);
393
394     int libvlc_playlist_add(LibVlcInstance instance, String uri, String name, libvlc_exception_t exception);
395
396     int libvlc_playlist_delete_item(LibVlcInstance instance, int itemIndex, libvlc_exception_t exception);
397
398     LibVlcMediaInstance libvlc_playlist_get_media_player(LibVlcInstance instance, libvlc_exception_t exception);
399
400     int libvlc_media_player_is_seekable(LibVlcMediaInstance instance, libvlc_exception_t exception);
401
402     int libvlc_media_player_can_pause(LibVlcMediaInstance instance, libvlc_exception_t exception);
403
404     // media descriptor
405
406     LibVlcMediaDescriptor libvlc_media_new(LibVlcInstance libvlc_instance, String mrl, libvlc_exception_t exception);
407
408     void libvlc_media_add_option(LibVlcMediaDescriptor media, String option, libvlc_exception_t exception);
409
410     String libvlc_media_get_mrl(LibVlcMediaDescriptor media);
411
412     void libvlc_media_release(LibVlcMediaDescriptor media);
413
414     LibVlcEventManager libvlc_media_event_manager(LibVlcMediaDescriptor media, libvlc_exception_t exception);
415
416     // media player
417
418     LibVlcMediaInstance libvlc_media_player_new(LibVlcInstance instance, libvlc_exception_t exception);
419
420     LibVlcMediaInstance libvlc_media_player_new_from_media(LibVlcMediaDescriptor media, libvlc_exception_t exception);
421
422     void libvlc_media_player_play(LibVlcMediaInstance media_player, libvlc_exception_t exception);
423
424     void libvlc_media_player_pause(LibVlcMediaInstance media_player, libvlc_exception_t exception);
425
426     void libvlc_media_player_stop(LibVlcMediaInstance media_player, libvlc_exception_t exception);
427
428     void libvlc_media_player_set_drawable(LibVlcMediaInstance libvlc_media_player, int drawable,
429         libvlc_exception_t exception);
430
431     long libvlc_media_player_get_length(LibVlcMediaInstance instance, libvlc_exception_t exception);
432
433     long libvlc_media_player_get_time(LibVlcMediaInstance instance, libvlc_exception_t exception);
434
435     void libvlc_media_player_set_time(LibVlcMediaInstance instance, long time, libvlc_exception_t exception);
436
437     float libvlc_media_player_get_position(LibVlcMediaInstance instance, libvlc_exception_t exception);
438
439     void libvlc_media_player_set_position(LibVlcMediaInstance instance, float position, libvlc_exception_t exception);
440
441     int libvlc_media_player_will_play(LibVlcMediaInstance instance, libvlc_exception_t exception);
442
443     void libvlc_media_player_set_rate(LibVlcMediaInstance instance, float rate, libvlc_exception_t exception);
444
445     float libvlc_media_player_get_rate(LibVlcMediaInstance instance, libvlc_exception_t exception);
446
447     int libvlc_media_player_has_vout(LibVlcMediaInstance instance2, libvlc_exception_t exception);
448
449     float libvlc_media_player_get_fps(LibVlcMediaInstance instance2, libvlc_exception_t exception);
450
451     void libvlc_media_player_release(LibVlcMediaInstance instance);
452
453     LibVlcEventManager libvlc_media_player_event_manager(LibVlcMediaInstance media_player, libvlc_exception_t exception);
454
455     // media list
456
457     LibVlcMediaList libvlc_media_list_new(LibVlcInstance libvlc_instance, libvlc_exception_t exception);
458
459     void libvlc_media_list_release(LibVlcMediaList libVlcMediaList);
460
461     void libvlc_media_list_add_file_content(LibVlcMediaList libvlc_media_list, String fileName,
462         libvlc_exception_t exception);
463
464     void libvlc_media_list_set_media(LibVlcMediaList libvlc_media_list, LibVlcMediaDescriptor libvlc_media,
465         libvlc_exception_t exception);
466
467     LibVlcMediaDescriptor libvlc_media_list_media(LibVlcMediaList libvlc_media_list, libvlc_exception_t exception);
468
469     void libvlc_media_list_add_media(LibVlcMediaList libvlc_media_list, LibVlcMediaDescriptor libvlc_media,
470         libvlc_exception_t exception);
471
472     void libvlc_media_list_insert_media(LibVlcMediaList libvlc_media_list, LibVlcMediaDescriptor libvlc_media,
473         int position, libvlc_exception_t exception);
474
475     void libvlc_media_list_remove_index(LibVlcMediaList libvlc_media_list, int position, libvlc_exception_t exception);
476
477     int libvlc_media_list_count(LibVlcMediaList libvlc_media_list, libvlc_exception_t exception);
478
479     LibVlcMediaDescriptor libvlc_media_list_item_at_index(LibVlcMediaList libvlc_media_list, int position,
480         libvlc_exception_t exception);
481
482     int libvlc_media_list_index_of_item(LibVlcMediaList libvlc_media_list, LibVlcMediaDescriptor libvlc_media,
483         libvlc_exception_t exception);
484
485     int libvlc_media_list_is_readonly(LibVlcMediaList libvlc_media_list);
486
487     LibVlcEventManager libvlc_media_list_event_manager(LibVlcMediaList libvlc_media_list, libvlc_exception_t exception);
488
489     // libvlc_media_list_player
490
491     LibVlcMediaListPlayer libvlc_media_list_player_new(LibVlcInstance libvlc_media_player, libvlc_exception_t exception);
492
493     void libvlc_media_list_player_release(LibVlcMediaListPlayer libvlc_media_list_player);
494
495     void libvlc_media_list_player_set_media_player(LibVlcMediaListPlayer libvlc_media_list_player,
496         LibVlcMediaInstance libvlc_media_player, libvlc_exception_t exception);
497
498     void libvlc_media_list_player_set_media_list(LibVlcMediaListPlayer libvlc_media_list_player,
499         LibVlcMediaList libvlc_media_list, libvlc_exception_t exception);
500
501     void libvlc_media_list_player_play(LibVlcMediaListPlayer libvlc_media_list_player, libvlc_exception_t exception);
502
503     void libvlc_media_list_player_pause(LibVlcMediaListPlayer libvlc_media_list_player, libvlc_exception_t exception);
504
505     int libvlc_media_list_player_is_playing(LibVlcMediaListPlayer libvlc_media_list_player, libvlc_exception_t exception);
506
507     int libvlc_media_list_player_get_state(LibVlcMediaListPlayer libvlc_media_list_player, libvlc_exception_t exception);
508
509     void libvlc_media_list_player_play_item_at_index(LibVlcMediaListPlayer libvlc_media_list_player, int position,
510         libvlc_exception_t exception);
511
512     void libvlc_media_list_player_play_item(LibVlcMediaListPlayer libvlc_media_list_player,
513         LibVlcMediaDescriptor libvlc_media, libvlc_exception_t exception);
514
515     void libvlc_media_list_player_stop(LibVlcMediaListPlayer libvlc_media_list_player, libvlc_exception_t exception);
516
517     void libvlc_media_list_player_next(LibVlcMediaListPlayer libvlc_media_list_player, libvlc_exception_t exception);
518
519     // VLM
520
521     void libvlc_vlm_add_broadcast(LibVlcInstance p_instance, String psz_name, String psz_input, String psz_output,
522         int i_options, String[] ppsz_options, int b_enabled, int b_loop, libvlc_exception_t p_e);
523
524     void libvlc_vlm_add_vod(LibVlcInstance p_instance, String psz_name, String psz_input, int i_options,
525         String[] ppsz_options, int b_enabled, String psz_mux, libvlc_exception_t p_e);
526
527     void libvlc_vlm_del_media(LibVlcInstance p_instance, String psz_name, libvlc_exception_t p_e);
528
529     void libvlc_vlm_set_enabled(LibVlcInstance p_instance, String psz_name, int b_enabled, libvlc_exception_t p_e);
530
531     void libvlc_vlm_set_output(LibVlcInstance p_instance, String psz_name, String psz_output, libvlc_exception_t p_e);
532
533     void libvlc_vlm_set_input(LibVlcInstance p_instance, String psz_name, String psz_input, libvlc_exception_t p_e);
534
535     void libvlc_vlm_add_input(LibVlcInstance p_instance, String psz_name, String psz_input, libvlc_exception_t p_e);
536
537     void libvlc_vlm_set_loop(LibVlcInstance p_instance, String psz_name, int b_loop, libvlc_exception_t p_e);
538
539     void libvlc_vlm_set_mux(LibVlcInstance p_instance, String psz_name, String psz_mux, libvlc_exception_t p_e);
540
541     void libvlc_vlm_change_media(LibVlcInstance p_instance, String psz_name, String psz_input, String psz_output,
542         int i_options, String[] ppsz_options, int b_enabled, int b_loop, libvlc_exception_t p_e);
543
544     void libvlc_vlm_play_media(LibVlcInstance p_instance, String psz_name, libvlc_exception_t p_e);
545
546     void libvlc_vlm_stop_media(LibVlcInstance p_instance, String psz_name, libvlc_exception_t p_e);
547
548     void libvlc_vlm_pause_media(LibVlcInstance p_instance, String psz_name, libvlc_exception_t p_e);
549
550     void libvlc_vlm_seek_media(LibVlcInstance p_instance, String psz_name, float f_percentage, libvlc_exception_t p_e);
551
552     String libvlc_vlm_show_media(LibVlcInstance p_instance, String psz_name, libvlc_exception_t p_e);
553
554     void libvlc_vlm_release(LibVlcInstance p_instance, libvlc_exception_t p_e);
555
556     // event manager
557
558     public static interface LibVlcCallback extends Callback
559     {
560
561         void callback(libvlc_event_t libvlc_event, Pointer userData);
562     }
563
564     void libvlc_event_attach(LibVlcEventManager event_manager, int event_type, LibVlcCallback callback,
565         Pointer userData, libvlc_exception_t exception);
566
567     void libvlc_event_detach(LibVlcEventManager event_manager, int event_type, LibVlcCallback callback,
568         Pointer userData, libvlc_exception_t excecption);
569
570     void libvlc_toggle_fullscreen(LibVlcMediaInstance instance, libvlc_exception_t exception);
571
572     // logging
573
574     int libvlc_get_log_verbosity(LibVlcInstance p_instance, libvlc_exception_t p_e);
575
576     void libvlc_set_log_verbosity(LibVlcInstance p_instance, int level, libvlc_exception_t p_e);
577
578     LibVlcLog libvlc_log_open(LibVlcInstance p_instance, libvlc_exception_t p_e);
579
580     void libvlc_log_close(LibVlcLog p_log, libvlc_exception_t p_e);
581
582     int libvlc_log_count(LibVlcLog p_log, libvlc_exception_t p_e);
583
584     void libvlc_log_clear(LibVlcLog p_log, libvlc_exception_t p_e);
585
586     LibVlcLogIterator libvlc_log_get_iterator(LibVlcLog p_log, libvlc_exception_t p_e);
587
588     void libvlc_log_iterator_free(LibVlcLogIterator p_iter, libvlc_exception_t p_e);
589
590     int libvlc_log_iterator_has_next(LibVlcLogIterator p_iter, libvlc_exception_t p_e);
591
592     libvlc_log_message_t libvlc_log_iterator_next(LibVlcLogIterator p_iter, libvlc_log_message_t p_buffer,
593         libvlc_exception_t p_e);
594
595 }