GstEventAPI.java

/* 
 * Copyright (c) 2009 Levente Farkas
 * Copyright (c) 2007, 2008 Wayne Meissner
 * 
 * This file is part of gstreamer-java.
 *
 * This code is free software: you can redistribute it and/or modify it under
 * the terms of the GNU Lesser General Public License version 3 only, as
 * published by the Free Software Foundation.
 *
 * This code is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public License
 * version 3 for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * version 3 along with this work.  If not, see <http://www.gnu.org/licenses/>.
 */

package org.freedesktop.gstreamer.lowlevel;

import java.util.Arrays;
import java.util.List;

import org.freedesktop.gstreamer.Caps;
import org.freedesktop.gstreamer.ClockTime;
import org.freedesktop.gstreamer.Event;
import org.freedesktop.gstreamer.EventType;
import org.freedesktop.gstreamer.Format;
import org.freedesktop.gstreamer.QOSType;
import org.freedesktop.gstreamer.SeekType;
import org.freedesktop.gstreamer.Structure;
import org.freedesktop.gstreamer.TagList;
import org.freedesktop.gstreamer.lowlevel.annotations.CallerOwnsReturn;
import org.freedesktop.gstreamer.lowlevel.annotations.Invalidate;

import com.sun.jna.Pointer;
import com.sun.jna.ptr.PointerByReference;

/**
 * GstEvent functions
 */
public interface GstEventAPI extends com.sun.jna.Library {
    GstEventAPI GSTEVENT_API = GstNative.load(GstEventAPI.class);

    String gst_event_type_get_name(EventType type);
    int gst_event_type_get_flags(EventType type);

    GType gst_event_get_type();

    Structure gst_event_get_structure(Event event);

    /* custom event */
    Event gst_event_new_custom(EventType type, @Invalidate Structure structure);

    /* flush events */
    @CallerOwnsReturn Event gst_event_new_flush_start();
    Pointer ptr_gst_event_new_flush_start();
    @CallerOwnsReturn Event gst_event_new_flush_stop();
    Pointer ptr_gst_event_new_flush_stop();
    
    /* EOS event */
    @CallerOwnsReturn Event gst_event_new_eos();
    Pointer ptr_gst_event_new_eos();
    
    /* newsegment events */
    @CallerOwnsReturn Event gst_event_new_segment( GstAPI.GstSegmentStruct segmentStruct );
    Pointer ptr_gst_event_new_segment( GstAPI.GstSegmentStruct segment);            
    void gst_event_parse_segment(Event event, Pointer[] pointer);
    
    /* tag event */
    @CallerOwnsReturn Event gst_event_new_tag(@Invalidate TagList taglist);
    Pointer ptr_gst_event_new_tag(@Invalidate TagList taglist);
    void gst_event_parse_tag(Event event, PointerByReference taglist);
    void gst_event_parse_tag(Event event, Pointer[] taglist);
    
    /* buffer event */
    @CallerOwnsReturn Event gst_event_new_buffer_size(Format format, long minsize, long maxsize, boolean async);
    Pointer ptr_gst_event_new_buffer_size(Format format, long minsize, long maxsize, boolean async);
    void gst_event_parse_buffer_size(Event event, Format[] format, long[] minsize,
						 long[] maxsize, boolean[] async);
    
    /* QOS events */
    @CallerOwnsReturn Event gst_event_new_qos(QOSType type, double proportion, long diff, ClockTime timestamp);
    @CallerOwnsReturn Event gst_event_new_qos(QOSType type, double proportion, long diff, long timestamp);
    Pointer ptr_gst_event_new_qos(QOSType type, double proportion, long diff, ClockTime timestamp);
    void gst_event_parse_qos(Event event, QOSType[] type, double[] proportion, long[] diff, ClockTime[] timestamp);
    void gst_event_parse_qos(Event event, QOSType[] type, double[] proportion, long[] diff, long[] timestamp);
    
    /* seek event */
    @CallerOwnsReturn Event gst_event_new_seek(double rate, Format format, int flags,
						 SeekType start_type, long start,
						 SeekType stop_type, long stop);
    Pointer ptr_gst_event_new_seek(double rate, Format format, int flags,
            SeekType start_type, long start, SeekType stop_type, long stop);
    void gst_event_parse_seek(Event event, double[] rate, Format[] format,
		                                 int[] flags, SeekType[] start_type, long[] start,
                                                 SeekType[] stop_type, long[] stop);
        
    /* navigation event */
    @CallerOwnsReturn Event gst_event_new_navigation(@Invalidate Structure structure);
    Pointer ptr_gst_event_new_navigation(@Invalidate Structure structure);

    /* latency event */
    @CallerOwnsReturn Event gst_event_new_latency(ClockTime latency);
    Pointer ptr_gst_event_new_latency(ClockTime latency);
    void gst_event_parse_latency(Event event, ClockTime[] latency);
    
    /* step event */
    @CallerOwnsReturn Event gst_event_new_step(Format format, long amount, double rate, boolean flush, boolean intermediate);
    Pointer ptr_gst_event_new_step(Format format, long amount, double rate, boolean flush, boolean intermediate);
    
    /* caps event */
    @CallerOwnsReturn Event gst_event_new_caps(Caps caps);
    Pointer ptr_gst_event_new_caps(Caps caps);
    
    /* reconfigure event */
    @CallerOwnsReturn Event gst_event_new_reconfigure();
    Pointer ptr_gst_event_new_reconfigure();
    
    /* stream start event */
    @CallerOwnsReturn Event gst_event_new_stream_start(final String stream_id);
    Pointer ptr_gst_event_new_stream_start(final String stream_id);
    
    
    public static final class EventStruct extends com.sun.jna.Structure {
        public volatile GstMiniObjectAPI.MiniObjectStruct mini_object;
        public volatile int type;
        public EventStruct(Pointer ptr) {
            useMemory(ptr);
        }

        @Override
        protected List<String> getFieldOrder() {
            return Arrays.asList(new String[]{
                "mini_object", "type"
            });
        }
    }
}