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 import com.sun.jna.Native;
  39
  40 public class JVLC
  41 {
  42
  43     private final LibVlcInstance instance;
  44
  45     private final LibVlc libvlc = LibVlc.SYNC_INSTANCE;
  46
  47     private MediaList mediaList;
  48
  49     private VLM vlm;
  50
  51     private volatile boolean released;
  52
  53     public JVLC()
  54     {
  55         String[] args = new String[] {};
  56         instance = createInstance(args);
  57         mediaList = new MediaList(this);
  58     }
  59
  60     public JVLC(String[] args)
  61     {
  62         instance = createInstance(args);
  63     }
  64
  65     public JVLC(String args)
  66     {
  67         this(args.split(" "));
  68     }
  69
  70     /*
  71      * Core methods
  72      */
  73     private LibVlcInstance createInstance(String[] args)
  74     {
  75         libvlc_exception_t exception = new libvlc_exception_t();
  76         return libvlc.libvlc_new(args.length, args, exception);
  77     }
  78
  79     public MediaInstance play(String media)
  80     {
  81         MediaDescriptor mediaDescriptor = new MediaDescriptor(this, media);
  82         MediaInstance mediaInstance = new MediaInstance(mediaDescriptor);
  83         mediaInstance.play();
  84         mediaDescriptor.release();
  85         return mediaInstance;
  86     }
  87
  88     public void setVideoOutput(Canvas canvas)
  89     {
  90         long drawable = Native.getComponentID(canvas);
  91         libvlc_exception_t exception = new libvlc_exception_t();
  92         libvlc.libvlc_video_set_parent(instance, drawable, exception );
  93     }
  94
  95     public Logger getLogger()
  96     {
  97         return new Logger(this);
  98     }
  99
 100     /**
 101      * Returns the mediaList.
 102      * @return the mediaList
 103      */
 104     public MediaList getMediaList()
 105     {
 106         return mediaList;
 107     }
 108
 109     public VLM getVLM()
 110     {
 111         if (vlm != null)
 112         {
 113             vlm.release();
 114         }
 115         this.vlm = new VLM(this);
 116         return vlm;
 117     }
 118
 119     public LoggerVerbosityLevel getLogVerbosity()
 120     {
 121         libvlc_exception_t exception = new libvlc_exception_t();
 122         int level = libvlc.libvlc_get_log_verbosity(instance, exception);
 123         return LoggerVerbosityLevel.getSeverity(level);
 124     }
 125
 126     public void setLogVerbosity(LoggerVerbosityLevel level)
 127     {
 128         libvlc_exception_t exception = new libvlc_exception_t();
 129         libvlc.libvlc_set_log_verbosity(instance, level.ordinal(), exception);
 130     }
 131
 132
 133     /**
 134      * Returns the _instance.
 135      * @return the _instance
 136      */
 137     LibVlcInstance getInstance()
 138     {
 139         return instance;
 140     }
 141
 142     /**
 143      * Returns the libvlc.
 144      * @return the libvlc
 145      */
 146     LibVlc getLibvlc()
 147     {
 148         return libvlc;
 149     }
 150
 151     /**
 152      * Releases this instance and the native resources.
 153      */
 154     public void release()
 155     {
 156         if (released)
 157         {
 158             return;
 159         }
 160         released = true;
 161         if (vlm != null)
 162         {
 163             vlm.release();
 164             vlm = null;
 165         }
 166         libvlc.libvlc_release(instance);
 167     }
 168
 169     /*
 170      * (non-Javadoc)
 171      * @see java.lang.Object#finalize()
 172      */
 173     @Override
 174     protected void finalize() throws Throwable
 175     {
 176         release();
 177         super.finalize();
 178     }
 179
 180 }