2009-05-16 19:23:34 +02:00
|
|
|
/*****************************************************************************
|
|
|
|
* vlc_picture.h: picture definitions
|
|
|
|
*****************************************************************************
|
LGPL
Re-license almost all of libVLC and libVLCcore to LGPLv2.1+
This move was authorized by the developers, either:
- by e-mail,
- by vote at the VideoLAN Dev Days 2011,
- on the license website,
- in a contract, oral or written.
No objection was raised, so far.
The developers agreeing are:
Justus Piater
Alexis Ballier
Alexander Bethke
Mohammed Adnène Trojette
Alex Converse
Alexey Sokolov
Alexis de Lattre
Andre Pang
Anthony Loiseau
Cyril Deguet
André Weber
Boris Dorès
Brieuc Jeunhomme
Benjamin Drung
Hugo Beauzée-Luyssen
Benoit Steiner
Benjamin Pracht
Bernie Purcell
Przemyslaw Fiala
Arnaud de Bossoreille de Ribou
Brad Smith
Nick Briggs
Christopher Rath
Christophe Courtaut
Christopher Mueller
Clement Chesnin
Andres Krapf
Damien Fouilleul
David Flynn
Sebastien Zwickert
Antoine Cellerier
Jérôme Decoodt
Jérome Decoodt
Dylan Yudaken
Eduard Babayan
Eugenio Jarosiewicz
Elliot Murphy
Eric Petit
Erwan Tulou
Etienne Membrives
Ludovic Fauvet
Fabio Ritrovato
Tobias Güntner
Jakub Wieczorek
Frédéric Crozat
Francois Cartegnie
Laurent Aimar
Florian G. Pflug
Felix Paul Kühne
Frank Enderle
Rafaël Carré
Simon Latapie
Gildas Bazin
Geoffroy Couprie
Julien / Gellule
Gildas Bazin
Arnaud Schauly
Toralf Niebuhr
Vicente Jimenez Aguilar
Derk-Jan Hartman
Henri Fallon
Ilkka Ollakka
Olivier Teulière
Rémi Duraffort
Jakob Leben
Jean-Baptiste Kempf
Jean-Paul Saman
Jean-Philippe Grimaldi
Jean-François Massol
Gaël Hendryckx
Jakob Leben
Jean-Marc Dressler
Jai Menon
Johan Bilien
Johann Ransay
Joris van Rooij
JP Dinger
Jean-Philippe André
Adrien Grand
Juha Jeronen
Juho Vähä-Herttua
Kaarlo Raiha
Kaarlo Raiha
Kamil Baldyga
Keary Griffin
Ken Self
KO Myung-Hun
Pierre Ynard
Filippo Carone
Loïc Minier
Luca Barbato
Lucas C. Villa Real
Lukas Durfina
Adrien Maglo
Marc Ariberti
Mark Lee
Mark Moriarty
Martin Storsjö
Christophe Massiot
Michel Kaempf
Marian Ďurkovič
Mirsal Ennaime
Carlo Calabrò
Damien Lucas
Naohiro Koriyama
Basos G
Pierre Baillet
Vincent Penquerc'h
Olivier Aubert
Pankaj Yadav
Paul Corke
Pierre d'Herbemont
Philippe Morin
Antoine Lejeune
Michael Ploujnikov
Jean-Marc Dressler
Michael Hanselmann
Rafaël Carré
Ramiro Polla
Rémi Denis-Courmont
Renaud Dartus
Richard Shepherd
Faustino Osuna
Arnaud Vallat
Rob Jonson
Robert Jedrzejczyk
Steve Lhomme
Rocky Bernstein
Romain Goyet
Rov Juvano
Sam Hocevar
Martin T. H. Sandsmark
Sebastian Birk
Sébastien Escudier
Vincent Seguin
Fabio Ritrovato
Sigmund Augdal Helberg
Casian Andrei
Srikanth Raju
Hannes Domani
Stéphane Borel
Stephan Krempel
Stephan Assmus
Tony Castley
Pavlov Konstantin
Eric Petit
Tanguy Krotoff
Dennis van Amerongen
Michel Lespinasse
Can Wu
Xavier Marchesini
Sébastien Toque
Christophe Mutricy
Yoann Peronneau
Yohann Martineau
Yuval Tze
Scott Caudle
Clément Stenac
It is possible, that some minor piece of code was badly tracked, for
some reasons (SVN, mainly) or that some small developers did not answer.
However, as an "œuvre collective", defined as in "CPI 113-2 alinéa 3",
and seeing "Cour. Cass. 17 Mai 1978", and seeing that the editor and
the very vast majority of developers have agreed (> 99.99% of the code,
> 99% of developers), we are fine here.
2011-11-27 21:44:15 +01:00
|
|
|
* Copyright (C) 1999 - 2009 VLC authors and VideoLAN
|
2009-05-16 19:23:34 +02:00
|
|
|
* $Id$
|
|
|
|
*
|
|
|
|
* Authors: Vincent Seguin <seguin@via.ecp.fr>
|
|
|
|
* Samuel Hocevar <sam@via.ecp.fr>
|
|
|
|
* Olivier Aubert <oaubert 47 videolan d07 org>
|
|
|
|
*
|
LGPL
Re-license almost all of libVLC and libVLCcore to LGPLv2.1+
This move was authorized by the developers, either:
- by e-mail,
- by vote at the VideoLAN Dev Days 2011,
- on the license website,
- in a contract, oral or written.
No objection was raised, so far.
The developers agreeing are:
Justus Piater
Alexis Ballier
Alexander Bethke
Mohammed Adnène Trojette
Alex Converse
Alexey Sokolov
Alexis de Lattre
Andre Pang
Anthony Loiseau
Cyril Deguet
André Weber
Boris Dorès
Brieuc Jeunhomme
Benjamin Drung
Hugo Beauzée-Luyssen
Benoit Steiner
Benjamin Pracht
Bernie Purcell
Przemyslaw Fiala
Arnaud de Bossoreille de Ribou
Brad Smith
Nick Briggs
Christopher Rath
Christophe Courtaut
Christopher Mueller
Clement Chesnin
Andres Krapf
Damien Fouilleul
David Flynn
Sebastien Zwickert
Antoine Cellerier
Jérôme Decoodt
Jérome Decoodt
Dylan Yudaken
Eduard Babayan
Eugenio Jarosiewicz
Elliot Murphy
Eric Petit
Erwan Tulou
Etienne Membrives
Ludovic Fauvet
Fabio Ritrovato
Tobias Güntner
Jakub Wieczorek
Frédéric Crozat
Francois Cartegnie
Laurent Aimar
Florian G. Pflug
Felix Paul Kühne
Frank Enderle
Rafaël Carré
Simon Latapie
Gildas Bazin
Geoffroy Couprie
Julien / Gellule
Gildas Bazin
Arnaud Schauly
Toralf Niebuhr
Vicente Jimenez Aguilar
Derk-Jan Hartman
Henri Fallon
Ilkka Ollakka
Olivier Teulière
Rémi Duraffort
Jakob Leben
Jean-Baptiste Kempf
Jean-Paul Saman
Jean-Philippe Grimaldi
Jean-François Massol
Gaël Hendryckx
Jakob Leben
Jean-Marc Dressler
Jai Menon
Johan Bilien
Johann Ransay
Joris van Rooij
JP Dinger
Jean-Philippe André
Adrien Grand
Juha Jeronen
Juho Vähä-Herttua
Kaarlo Raiha
Kaarlo Raiha
Kamil Baldyga
Keary Griffin
Ken Self
KO Myung-Hun
Pierre Ynard
Filippo Carone
Loïc Minier
Luca Barbato
Lucas C. Villa Real
Lukas Durfina
Adrien Maglo
Marc Ariberti
Mark Lee
Mark Moriarty
Martin Storsjö
Christophe Massiot
Michel Kaempf
Marian Ďurkovič
Mirsal Ennaime
Carlo Calabrò
Damien Lucas
Naohiro Koriyama
Basos G
Pierre Baillet
Vincent Penquerc'h
Olivier Aubert
Pankaj Yadav
Paul Corke
Pierre d'Herbemont
Philippe Morin
Antoine Lejeune
Michael Ploujnikov
Jean-Marc Dressler
Michael Hanselmann
Rafaël Carré
Ramiro Polla
Rémi Denis-Courmont
Renaud Dartus
Richard Shepherd
Faustino Osuna
Arnaud Vallat
Rob Jonson
Robert Jedrzejczyk
Steve Lhomme
Rocky Bernstein
Romain Goyet
Rov Juvano
Sam Hocevar
Martin T. H. Sandsmark
Sebastian Birk
Sébastien Escudier
Vincent Seguin
Fabio Ritrovato
Sigmund Augdal Helberg
Casian Andrei
Srikanth Raju
Hannes Domani
Stéphane Borel
Stephan Krempel
Stephan Assmus
Tony Castley
Pavlov Konstantin
Eric Petit
Tanguy Krotoff
Dennis van Amerongen
Michel Lespinasse
Can Wu
Xavier Marchesini
Sébastien Toque
Christophe Mutricy
Yoann Peronneau
Yohann Martineau
Yuval Tze
Scott Caudle
Clément Stenac
It is possible, that some minor piece of code was badly tracked, for
some reasons (SVN, mainly) or that some small developers did not answer.
However, as an "œuvre collective", defined as in "CPI 113-2 alinéa 3",
and seeing "Cour. Cass. 17 Mai 1978", and seeing that the editor and
the very vast majority of developers have agreed (> 99.99% of the code,
> 99% of developers), we are fine here.
2011-11-27 21:44:15 +01:00
|
|
|
* This program is free software; you can redistribute it and/or modify it
|
|
|
|
* under the terms of the GNU Lesser General Public License as published by
|
|
|
|
* the Free Software Foundation; either version 2.1 of the License, or
|
2009-05-16 19:23:34 +02:00
|
|
|
* (at your option) any later version.
|
|
|
|
*
|
|
|
|
* This program is distributed in the hope that it will be useful,
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
LGPL
Re-license almost all of libVLC and libVLCcore to LGPLv2.1+
This move was authorized by the developers, either:
- by e-mail,
- by vote at the VideoLAN Dev Days 2011,
- on the license website,
- in a contract, oral or written.
No objection was raised, so far.
The developers agreeing are:
Justus Piater
Alexis Ballier
Alexander Bethke
Mohammed Adnène Trojette
Alex Converse
Alexey Sokolov
Alexis de Lattre
Andre Pang
Anthony Loiseau
Cyril Deguet
André Weber
Boris Dorès
Brieuc Jeunhomme
Benjamin Drung
Hugo Beauzée-Luyssen
Benoit Steiner
Benjamin Pracht
Bernie Purcell
Przemyslaw Fiala
Arnaud de Bossoreille de Ribou
Brad Smith
Nick Briggs
Christopher Rath
Christophe Courtaut
Christopher Mueller
Clement Chesnin
Andres Krapf
Damien Fouilleul
David Flynn
Sebastien Zwickert
Antoine Cellerier
Jérôme Decoodt
Jérome Decoodt
Dylan Yudaken
Eduard Babayan
Eugenio Jarosiewicz
Elliot Murphy
Eric Petit
Erwan Tulou
Etienne Membrives
Ludovic Fauvet
Fabio Ritrovato
Tobias Güntner
Jakub Wieczorek
Frédéric Crozat
Francois Cartegnie
Laurent Aimar
Florian G. Pflug
Felix Paul Kühne
Frank Enderle
Rafaël Carré
Simon Latapie
Gildas Bazin
Geoffroy Couprie
Julien / Gellule
Gildas Bazin
Arnaud Schauly
Toralf Niebuhr
Vicente Jimenez Aguilar
Derk-Jan Hartman
Henri Fallon
Ilkka Ollakka
Olivier Teulière
Rémi Duraffort
Jakob Leben
Jean-Baptiste Kempf
Jean-Paul Saman
Jean-Philippe Grimaldi
Jean-François Massol
Gaël Hendryckx
Jakob Leben
Jean-Marc Dressler
Jai Menon
Johan Bilien
Johann Ransay
Joris van Rooij
JP Dinger
Jean-Philippe André
Adrien Grand
Juha Jeronen
Juho Vähä-Herttua
Kaarlo Raiha
Kaarlo Raiha
Kamil Baldyga
Keary Griffin
Ken Self
KO Myung-Hun
Pierre Ynard
Filippo Carone
Loïc Minier
Luca Barbato
Lucas C. Villa Real
Lukas Durfina
Adrien Maglo
Marc Ariberti
Mark Lee
Mark Moriarty
Martin Storsjö
Christophe Massiot
Michel Kaempf
Marian Ďurkovič
Mirsal Ennaime
Carlo Calabrò
Damien Lucas
Naohiro Koriyama
Basos G
Pierre Baillet
Vincent Penquerc'h
Olivier Aubert
Pankaj Yadav
Paul Corke
Pierre d'Herbemont
Philippe Morin
Antoine Lejeune
Michael Ploujnikov
Jean-Marc Dressler
Michael Hanselmann
Rafaël Carré
Ramiro Polla
Rémi Denis-Courmont
Renaud Dartus
Richard Shepherd
Faustino Osuna
Arnaud Vallat
Rob Jonson
Robert Jedrzejczyk
Steve Lhomme
Rocky Bernstein
Romain Goyet
Rov Juvano
Sam Hocevar
Martin T. H. Sandsmark
Sebastian Birk
Sébastien Escudier
Vincent Seguin
Fabio Ritrovato
Sigmund Augdal Helberg
Casian Andrei
Srikanth Raju
Hannes Domani
Stéphane Borel
Stephan Krempel
Stephan Assmus
Tony Castley
Pavlov Konstantin
Eric Petit
Tanguy Krotoff
Dennis van Amerongen
Michel Lespinasse
Can Wu
Xavier Marchesini
Sébastien Toque
Christophe Mutricy
Yoann Peronneau
Yohann Martineau
Yuval Tze
Scott Caudle
Clément Stenac
It is possible, that some minor piece of code was badly tracked, for
some reasons (SVN, mainly) or that some small developers did not answer.
However, as an "œuvre collective", defined as in "CPI 113-2 alinéa 3",
and seeing "Cour. Cass. 17 Mai 1978", and seeing that the editor and
the very vast majority of developers have agreed (> 99.99% of the code,
> 99% of developers), we are fine here.
2011-11-27 21:44:15 +01:00
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
* GNU Lesser General Public License for more details.
|
2009-05-16 19:23:34 +02:00
|
|
|
*
|
LGPL
Re-license almost all of libVLC and libVLCcore to LGPLv2.1+
This move was authorized by the developers, either:
- by e-mail,
- by vote at the VideoLAN Dev Days 2011,
- on the license website,
- in a contract, oral or written.
No objection was raised, so far.
The developers agreeing are:
Justus Piater
Alexis Ballier
Alexander Bethke
Mohammed Adnène Trojette
Alex Converse
Alexey Sokolov
Alexis de Lattre
Andre Pang
Anthony Loiseau
Cyril Deguet
André Weber
Boris Dorès
Brieuc Jeunhomme
Benjamin Drung
Hugo Beauzée-Luyssen
Benoit Steiner
Benjamin Pracht
Bernie Purcell
Przemyslaw Fiala
Arnaud de Bossoreille de Ribou
Brad Smith
Nick Briggs
Christopher Rath
Christophe Courtaut
Christopher Mueller
Clement Chesnin
Andres Krapf
Damien Fouilleul
David Flynn
Sebastien Zwickert
Antoine Cellerier
Jérôme Decoodt
Jérome Decoodt
Dylan Yudaken
Eduard Babayan
Eugenio Jarosiewicz
Elliot Murphy
Eric Petit
Erwan Tulou
Etienne Membrives
Ludovic Fauvet
Fabio Ritrovato
Tobias Güntner
Jakub Wieczorek
Frédéric Crozat
Francois Cartegnie
Laurent Aimar
Florian G. Pflug
Felix Paul Kühne
Frank Enderle
Rafaël Carré
Simon Latapie
Gildas Bazin
Geoffroy Couprie
Julien / Gellule
Gildas Bazin
Arnaud Schauly
Toralf Niebuhr
Vicente Jimenez Aguilar
Derk-Jan Hartman
Henri Fallon
Ilkka Ollakka
Olivier Teulière
Rémi Duraffort
Jakob Leben
Jean-Baptiste Kempf
Jean-Paul Saman
Jean-Philippe Grimaldi
Jean-François Massol
Gaël Hendryckx
Jakob Leben
Jean-Marc Dressler
Jai Menon
Johan Bilien
Johann Ransay
Joris van Rooij
JP Dinger
Jean-Philippe André
Adrien Grand
Juha Jeronen
Juho Vähä-Herttua
Kaarlo Raiha
Kaarlo Raiha
Kamil Baldyga
Keary Griffin
Ken Self
KO Myung-Hun
Pierre Ynard
Filippo Carone
Loïc Minier
Luca Barbato
Lucas C. Villa Real
Lukas Durfina
Adrien Maglo
Marc Ariberti
Mark Lee
Mark Moriarty
Martin Storsjö
Christophe Massiot
Michel Kaempf
Marian Ďurkovič
Mirsal Ennaime
Carlo Calabrò
Damien Lucas
Naohiro Koriyama
Basos G
Pierre Baillet
Vincent Penquerc'h
Olivier Aubert
Pankaj Yadav
Paul Corke
Pierre d'Herbemont
Philippe Morin
Antoine Lejeune
Michael Ploujnikov
Jean-Marc Dressler
Michael Hanselmann
Rafaël Carré
Ramiro Polla
Rémi Denis-Courmont
Renaud Dartus
Richard Shepherd
Faustino Osuna
Arnaud Vallat
Rob Jonson
Robert Jedrzejczyk
Steve Lhomme
Rocky Bernstein
Romain Goyet
Rov Juvano
Sam Hocevar
Martin T. H. Sandsmark
Sebastian Birk
Sébastien Escudier
Vincent Seguin
Fabio Ritrovato
Sigmund Augdal Helberg
Casian Andrei
Srikanth Raju
Hannes Domani
Stéphane Borel
Stephan Krempel
Stephan Assmus
Tony Castley
Pavlov Konstantin
Eric Petit
Tanguy Krotoff
Dennis van Amerongen
Michel Lespinasse
Can Wu
Xavier Marchesini
Sébastien Toque
Christophe Mutricy
Yoann Peronneau
Yohann Martineau
Yuval Tze
Scott Caudle
Clément Stenac
It is possible, that some minor piece of code was badly tracked, for
some reasons (SVN, mainly) or that some small developers did not answer.
However, as an "œuvre collective", defined as in "CPI 113-2 alinéa 3",
and seeing "Cour. Cass. 17 Mai 1978", and seeing that the editor and
the very vast majority of developers have agreed (> 99.99% of the code,
> 99% of developers), we are fine here.
2011-11-27 21:44:15 +01:00
|
|
|
* You should have received a copy of the GNU Lesser General Public License
|
|
|
|
* along with this program; if not, write to the Free Software Foundation,
|
|
|
|
* Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
|
2009-05-16 19:23:34 +02:00
|
|
|
*****************************************************************************/
|
|
|
|
|
|
|
|
#ifndef VLC_PICTURE_H
|
|
|
|
#define VLC_PICTURE_H 1
|
|
|
|
|
|
|
|
/**
|
|
|
|
* \file
|
|
|
|
* This file defines picture structures and functions in vlc
|
|
|
|
*/
|
|
|
|
|
|
|
|
#include <vlc_es.h>
|
|
|
|
|
|
|
|
/** Description of a planar graphic field */
|
|
|
|
typedef struct plane_t
|
|
|
|
{
|
|
|
|
uint8_t *p_pixels; /**< Start of the plane's data */
|
|
|
|
|
|
|
|
/* Variables used for fast memcpy operations */
|
|
|
|
int i_lines; /**< Number of lines, including margins */
|
|
|
|
int i_pitch; /**< Number of bytes in a line, including margins */
|
|
|
|
|
|
|
|
/** Size of a macropixel, defaults to 1 */
|
|
|
|
int i_pixel_pitch;
|
|
|
|
|
|
|
|
/* Variables used for pictures with margins */
|
|
|
|
int i_visible_lines; /**< How many visible lines are there ? */
|
|
|
|
int i_visible_pitch; /**< How many visible pixels are there ? */
|
|
|
|
|
|
|
|
} plane_t;
|
|
|
|
|
2009-05-31 01:23:46 +02:00
|
|
|
/**
|
|
|
|
* Maximum number of plane for a picture
|
|
|
|
*/
|
|
|
|
#define PICTURE_PLANE_MAX (VOUT_MAX_PLANES)
|
|
|
|
|
2016-11-27 21:33:17 +01:00
|
|
|
typedef struct picture_context_t
|
|
|
|
{
|
|
|
|
void (*destroy)(struct picture_context_t *);
|
2017-06-05 19:56:40 +02:00
|
|
|
struct picture_context_t *(*copy)(struct picture_context_t *);
|
2016-11-27 21:33:17 +01:00
|
|
|
} picture_context_t;
|
|
|
|
|
2009-05-16 19:23:34 +02:00
|
|
|
/**
|
|
|
|
* Video picture
|
|
|
|
*/
|
|
|
|
struct picture_t
|
|
|
|
{
|
|
|
|
/**
|
|
|
|
* The properties of the picture
|
|
|
|
*/
|
|
|
|
video_frame_format_t format;
|
|
|
|
|
2009-05-31 01:23:46 +02:00
|
|
|
plane_t p[PICTURE_PLANE_MAX]; /**< description of the planes */
|
2009-05-16 19:23:34 +02:00
|
|
|
int i_planes; /**< number of allocated planes */
|
|
|
|
|
|
|
|
/** \name Picture management properties
|
|
|
|
* These properties can be modified using the video output thread API,
|
|
|
|
* but should never be written directly */
|
|
|
|
/**@{*/
|
|
|
|
mtime_t date; /**< display date */
|
|
|
|
bool b_force;
|
|
|
|
/**@}*/
|
|
|
|
|
|
|
|
/** \name Picture dynamic properties
|
|
|
|
* Those properties can be changed by the decoder
|
|
|
|
* @{
|
|
|
|
*/
|
|
|
|
bool b_progressive; /**< is it a progressive frame ? */
|
|
|
|
bool b_top_field_first; /**< which field is first */
|
2009-12-22 15:46:54 +01:00
|
|
|
unsigned int i_nb_fields; /**< # of displayed fields */
|
2016-11-27 21:33:17 +01:00
|
|
|
picture_context_t *context; /**< video format-specific data pointer */
|
2009-05-16 19:23:34 +02:00
|
|
|
/**@}*/
|
|
|
|
|
|
|
|
/** Private data - the video output plugin might want to put stuff here to
|
|
|
|
* keep track of the picture */
|
|
|
|
picture_sys_t * p_sys;
|
|
|
|
|
|
|
|
/** Next picture in a FIFO a pictures */
|
|
|
|
struct picture_t *p_next;
|
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
|
|
|
* This function will create a new picture.
|
|
|
|
* The picture created will implement a default release management compatible
|
|
|
|
* with picture_Hold and picture_Release. This default management will release
|
2013-03-09 20:38:28 +01:00
|
|
|
* p_sys, gc.p_sys fields if non NULL.
|
2009-05-16 19:23:34 +02:00
|
|
|
*/
|
2011-05-07 22:02:08 +02:00
|
|
|
VLC_API picture_t * picture_New( vlc_fourcc_t i_chroma, int i_width, int i_height, int i_sar_num, int i_sar_den ) VLC_USED;
|
2009-05-16 19:23:34 +02:00
|
|
|
|
2009-05-31 01:23:46 +02:00
|
|
|
/**
|
|
|
|
* This function will create a new picture using the given format.
|
|
|
|
*
|
2010-06-25 02:08:58 +02:00
|
|
|
* When possible, it is preferred to use this function over picture_New
|
2009-05-31 01:23:46 +02:00
|
|
|
* as more information about the format is kept.
|
|
|
|
*/
|
2011-05-07 22:02:08 +02:00
|
|
|
VLC_API picture_t * picture_NewFromFormat( const video_format_t *p_fmt ) VLC_USED;
|
2009-05-31 01:23:46 +02:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Resource for a picture.
|
|
|
|
*/
|
|
|
|
typedef struct
|
|
|
|
{
|
|
|
|
picture_sys_t *p_sys;
|
2013-07-14 21:03:08 +02:00
|
|
|
void (*pf_destroy)(picture_t *);
|
2009-05-31 01:23:46 +02:00
|
|
|
|
|
|
|
/* Plane resources
|
|
|
|
* XXX all fields MUST be set to the right value.
|
|
|
|
*/
|
|
|
|
struct
|
|
|
|
{
|
|
|
|
uint8_t *p_pixels; /**< Start of the plane's data */
|
|
|
|
int i_lines; /**< Number of lines, including margins */
|
|
|
|
int i_pitch; /**< Number of bytes in a line, including margins */
|
|
|
|
} p[PICTURE_PLANE_MAX];
|
|
|
|
|
|
|
|
} picture_resource_t;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* This function will create a new picture using the provided resource.
|
|
|
|
*
|
|
|
|
* If the resource is NULL then a plain picture_NewFromFormat is returned.
|
|
|
|
*/
|
2011-05-07 22:02:08 +02:00
|
|
|
VLC_API picture_t * picture_NewFromResource( const video_format_t *, const picture_resource_t * ) VLC_USED;
|
2009-05-31 01:23:46 +02:00
|
|
|
|
2009-05-16 19:23:34 +02:00
|
|
|
/**
|
|
|
|
* This function will increase the picture reference count.
|
|
|
|
* It will not have any effect on picture obtained from vout
|
2009-05-31 17:31:17 +02:00
|
|
|
*
|
|
|
|
* It returns the given picture for convenience.
|
2009-05-16 19:23:34 +02:00
|
|
|
*/
|
2012-01-19 20:37:08 +01:00
|
|
|
VLC_API picture_t *picture_Hold( picture_t *p_picture );
|
|
|
|
|
2009-05-16 19:23:34 +02:00
|
|
|
/**
|
|
|
|
* This function will release a picture.
|
|
|
|
* It will not have any effect on picture obtained from vout
|
|
|
|
*/
|
2012-01-19 20:37:08 +01:00
|
|
|
VLC_API void picture_Release( picture_t *p_picture );
|
2009-05-16 19:23:34 +02:00
|
|
|
|
|
|
|
/**
|
|
|
|
* This function will copy all picture dynamic properties.
|
|
|
|
*/
|
2012-01-19 20:37:08 +01:00
|
|
|
VLC_API void picture_CopyProperties( picture_t *p_dst, const picture_t *p_src );
|
2009-05-16 19:23:34 +02:00
|
|
|
|
2009-05-30 23:23:38 +02:00
|
|
|
/**
|
2010-07-28 21:03:32 +02:00
|
|
|
* This function will reset a picture information (properties and quantizers).
|
2010-06-05 10:10:50 +02:00
|
|
|
* It is sometimes useful for reusing pictures (like from a pool).
|
2009-05-30 23:23:38 +02:00
|
|
|
*/
|
2011-05-07 13:06:21 +02:00
|
|
|
VLC_API void picture_Reset( picture_t * );
|
2009-05-30 23:23:38 +02:00
|
|
|
|
2009-05-16 19:23:34 +02:00
|
|
|
/**
|
|
|
|
* This function will copy the picture pixels.
|
|
|
|
* You can safely copy between pictures that do not have the same size,
|
|
|
|
* only the compatible(smaller) part will be copied.
|
|
|
|
*/
|
2011-05-07 13:06:21 +02:00
|
|
|
VLC_API void picture_CopyPixels( picture_t *p_dst, const picture_t *p_src );
|
|
|
|
VLC_API void plane_CopyPixels( plane_t *p_dst, const plane_t *p_src );
|
2009-05-16 19:23:34 +02:00
|
|
|
|
|
|
|
/**
|
|
|
|
* This function will copy both picture dynamic properties and pixels.
|
|
|
|
* You have to notice that sometime a simple picture_Hold may do what
|
|
|
|
* you want without the copy overhead.
|
|
|
|
* Provided for convenience.
|
|
|
|
*
|
|
|
|
* \param p_dst pointer to the destination picture.
|
|
|
|
* \param p_src pointer to the source picture.
|
|
|
|
*/
|
2012-01-19 20:37:08 +01:00
|
|
|
VLC_API void picture_Copy( picture_t *p_dst, const picture_t *p_src );
|
2009-05-16 19:23:34 +02:00
|
|
|
|
2017-11-04 16:55:22 +01:00
|
|
|
/**
|
|
|
|
* Perform a shallow picture copy
|
|
|
|
*
|
|
|
|
* This function makes a shallow copy of an existing picture. The same planes
|
|
|
|
* and resources will be used, and the cloned picture reference count will be
|
|
|
|
* incremented.
|
|
|
|
*
|
|
|
|
* \return A clone picture on success, NULL on error.
|
|
|
|
*/
|
|
|
|
VLC_API picture_t *picture_Clone(picture_t *pic);
|
|
|
|
|
2009-05-16 19:23:34 +02:00
|
|
|
/**
|
|
|
|
* This function will export a picture to an encoded bitstream.
|
|
|
|
*
|
|
|
|
* pp_image will contain the encoded bitstream in psz_format format.
|
|
|
|
*
|
|
|
|
* p_fmt can be NULL otherwise it will be set with the format used for the
|
|
|
|
* picture before encoding.
|
|
|
|
*
|
|
|
|
* i_override_width/height allow to override the width and/or the height of the
|
2009-08-24 22:17:18 +02:00
|
|
|
* picture to be encoded:
|
|
|
|
* - if strictly lower than 0, the original dimension will be used.
|
|
|
|
* - if equal to 0, it will be deduced from the other dimension which must be
|
|
|
|
* different to 0.
|
|
|
|
* - if strictly higher than 0, it will override the dimension.
|
|
|
|
* If at most one of them is > 0 then the picture aspect ratio will be kept.
|
2009-05-16 19:23:34 +02:00
|
|
|
*/
|
2011-05-07 13:06:21 +02:00
|
|
|
VLC_API int picture_Export( vlc_object_t *p_obj, block_t **pp_image, video_format_t *p_fmt, picture_t *p_picture, vlc_fourcc_t i_format, int i_override_width, int i_override_height );
|
2009-05-16 19:23:34 +02:00
|
|
|
|
2009-05-16 20:47:41 +02:00
|
|
|
/**
|
|
|
|
* This function will setup all fields of a picture_t without allocating any
|
|
|
|
* memory.
|
|
|
|
* XXX The memory must already be initialized.
|
|
|
|
* It does not need to be released.
|
|
|
|
*
|
|
|
|
* It will return VLC_EGENERIC if the core does not understand the requested
|
|
|
|
* format.
|
|
|
|
*
|
2010-06-05 10:10:50 +02:00
|
|
|
* It can be useful to get the properties of planes.
|
2009-05-16 20:47:41 +02:00
|
|
|
*/
|
2014-03-11 22:48:57 +01:00
|
|
|
VLC_API int picture_Setup( picture_t *, const video_format_t * );
|
2009-05-16 20:47:41 +02:00
|
|
|
|
2010-12-11 18:32:42 +01:00
|
|
|
|
2009-05-16 19:23:34 +02:00
|
|
|
/*****************************************************************************
|
|
|
|
* Shortcuts to access image components
|
|
|
|
*****************************************************************************/
|
|
|
|
|
|
|
|
/* Plane indices */
|
|
|
|
enum
|
|
|
|
{
|
|
|
|
Y_PLANE = 0,
|
|
|
|
U_PLANE = 1,
|
|
|
|
V_PLANE = 2,
|
|
|
|
A_PLANE = 3,
|
|
|
|
};
|
|
|
|
|
|
|
|
/* Shortcuts */
|
|
|
|
#define Y_PIXELS p[Y_PLANE].p_pixels
|
|
|
|
#define Y_PITCH p[Y_PLANE].i_pitch
|
|
|
|
#define U_PIXELS p[U_PLANE].p_pixels
|
|
|
|
#define U_PITCH p[U_PLANE].i_pitch
|
|
|
|
#define V_PIXELS p[V_PLANE].p_pixels
|
|
|
|
#define V_PITCH p[V_PLANE].i_pitch
|
|
|
|
#define A_PIXELS p[A_PLANE].p_pixels
|
|
|
|
#define A_PITCH p[A_PLANE].i_pitch
|
|
|
|
|
|
|
|
/**@}*/
|
|
|
|
|
|
|
|
#endif /* VLC_PICTURE_H */
|