git.sesse.net Git - vlc/blob - bindings/java/core/src/main/java/org/videolan/jvlc/JVLC.java

   1 /*****************************************************************************
   2  * JVLC.java: Main Java Class, represents a libvlc_instance_t object
   3  *****************************************************************************
   4  *
   5  * Copyright (C) 1998-2008 the VideoLAN team
   6  *
   7  * Author: Filippo Carone <filippo@carone.org>
   8  *         Philippe Morin <phmorin@free.fr>
   9  *
  10  * Created on 28-feb-2006
  11  *
  12  * $Id: JVLC.java 20141 2007-05-16 19:31:35Z littlejohn $
  13  *
  14  * This program is free software; you can redistribute it
  15  * and/or modify it under the terms of the GNU General Public License
  16  * as published by the Free Software Foundation; either version 2 of the
  17  * License, or (at your option) any later version.
  18  *
  19  * This program is distributed in the hope that it will be useful, but
  20  * WITHOUT ANY WARRANTY; without even the implied warranty of
  21  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  22  * General Public License for more details.
  23  *
  24  * You should have received a copy of the GNU General Public
  25  * License along with this program; if not, write to the Free Software
  26  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  27  *
  28  */
  29
  30 package org.videolan.jvlc;
  31
  32 import java.awt.Canvas;
  33
  34 import org.videolan.jvlc.internal.LibVlc;
  35 import org.videolan.jvlc.internal.LibVlc.LibVlcInstance;
  36 import org.videolan.jvlc.internal.LibVlc.libvlc_exception_t;
  37
  38 public class JVLC
  39 {
  40
  41     private final LibVlcInstance instance;
  42
  43     private final LibVlc libvlc = LibVlc.SYNC_INSTANCE;
  44
  45     private VLM vlm;
  46
  47     private Audio audio;
  48
  49     private volatile boolean released;
  50
  51     private Canvas canvas;
  52
  53     public JVLC()
  54     {
  55         this(new String[] {});
  56     }
  57
  58     public JVLC(String[] args)
  59     {
  60         instance = createInstance(args);
  61         audio = new Audio(this);
  62     }
  63
  64     public JVLC(String args)
  65     {
  66         this(args.split(" "));
  67     }
  68
  69     /*
  70      * Core methods
  71      */
  72     private LibVlcInstance createInstance(String[] args)
  73     {
  74         libvlc_exception_t exception = new libvlc_exception_t();
  75         return libvlc.libvlc_new(args.length, args, exception);
  76     }
  77
  78     public MediaPlayer play(String media)
  79     {
  80         MediaDescriptor mediaDescriptor = new MediaDescriptor(this, media);
  81         MediaPlayer mediaPlayer = new MediaPlayer(mediaDescriptor);
  82         if (canvas != null)
  83         {
  84             mediaPlayer.setParent(canvas);
  85         }
  86         mediaPlayer.play();
  87         mediaDescriptor.release();
  88         return mediaPlayer;
  89     }
  90
  91     public void setVideoOutput(Canvas canvas)
  92     {
  93         this.canvas = canvas;
  94     }
  95
  96     public Logger getLogger()
  97     {
  98         return new Logger(this);
  99     }
 100
 101     public VLM getVLM()
 102     {
 103         if (vlm != null)
 104         {
 105             vlm.release();
 106         }
 107         this.vlm = new VLM(this);
 108         return vlm;
 109     }
 110
 111     public LoggerVerbosityLevel getLogVerbosity()
 112     {
 113         int level = libvlc.libvlc_get_log_verbosity(instance);
 114         return LoggerVerbosityLevel.getSeverity(level);
 115     }
 116
 117     public void setLogVerbosity(LoggerVerbosityLevel level)
 118     {
 119         libvlc.libvlc_set_log_verbosity(instance, level.ordinal());
 120     }
 121
 122
 123     /**
 124      * Returns the _instance.
 125      * @return the _instance
 126      */
 127     LibVlcInstance getInstance()
 128     {
 129         return instance;
 130     }
 131
 132     /**
 133      * Returns the libvlc.
 134      * @return the libvlc
 135      */
 136     LibVlc getLibvlc()
 137     {
 138         return libvlc;
 139     }
 140
 141     /**
 142      * Releases this instance and the native resources.
 143      */
 144     public void release()
 145     {
 146         if (released)
 147         {
 148             return;
 149         }
 150         released = true;
 151         if (vlm != null)
 152         {
 153             vlm.release();
 154             vlm = null;
 155         }
 156
 157         libvlc.libvlc_release(instance);
 158     }
 159
 160     /*
 161      * (non-Javadoc)
 162      * @see java.lang.Object#finalize()
 163      */
 164     @Override
 165     protected void finalize() throws Throwable
 166     {
 167         release();
 168         super.finalize();
 169     }
 170
 171     /**
 172      * @return
 173      */
 174     public Audio getAudio()
 175     {
 176         return audio;
 177     }
 178
 179 }