Difference between revisions of "Mac OS X Porting - Native Audio and Video"

From Apache OpenOffice Wiki
Jump to: navigation, search
(Tasks)
Line 10: Line 10:
  
 
===Tasks===
 
===Tasks===
 +
 +
OOo scope: avmedia module
  
 
Initial structure for the quicktime backend has been put up to [http://www.openoffice.org/issues/show_bug.cgi?id=69665 issue 69665]. It is based on the stub of Xine -backend, OOo milestone m184.
 
Initial structure for the quicktime backend has been put up to [http://www.openoffice.org/issues/show_bug.cgi?id=69665 issue 69665]. It is based on the stub of Xine -backend, OOo milestone m184.
Line 20: Line 22:
 
** Complete list of [http://developer.apple.com/documentation/QuickTime/APIREF/GettingandPlayingMovies.htm useful Quicktime functions]
 
** Complete list of [http://developer.apple.com/documentation/QuickTime/APIREF/GettingandPlayingMovies.htm useful Quicktime functions]
  
=== Design ===
+
* Use Radek Doulik and Cedric Bosdonnat work: [http://marketing.openoffice.org/ooocon2006/schedule/wednesday.html OOoCon 2006 presentation], [http://eric.bachard.free.fr/mac/OOoCon2006/GStreamer-in-OpenOffice.org.odp slides (ODP)]
  
Use Radek Doulik and Cedric Bosdonnat work
 
  
OOoCon presentation : http://eric.bachard.free.fr/mac/OOoCon2006/GStreamer-in-OpenOffice.org.odp
+
'''Related issues''':  
 +
Quicktime will not be able to play all windows .avi and .wma files, because it does not support them. We may need xine or some other player backend to see some of the OOo documents created on Windows OOo.
  
Concerned module : avmedia
+
For other backends, make sure that we don't build backends that we don't need (i.e. if defined QUARTZ/MACOSX)
  
The native sound implementation will use already existing windows implementation as model, replacing current avmedia implementation.
+
affected files (at least): avmedia/source/xine/makefile.mk
 
+
[work in progress]
+
 
+
Todo list :
+
 
+
Use existing windows iimplementation.
+
 
+
1) Create new tree in avmedia :
+
 
+
avmedia/source/macosx
+
 
+
Containing :
+
 
+
new makefile.mk
+
 
+
C++ files ( not sure the list is complete, to be confirmed ) :
+
macosxframegrabber.cxx, macosxmanager.cxx, macosxplayer.cxx, macosxwindow.cxx, macosxuno.cxx
+
 
+
headers will be put into avmedia/inc
+
 
+
(confirmed : is avmedia/inc the best place ?)
+
+
macosxframegrabber.hxx, macosxmanager.hxx, macosxplayer.hxx, macosxwindow.hxx, macosxuno.hxx, macosxplayerhelpers.hxx
+
 
+
2) Other modifications :
+
 
+
avmedia/source/xine/makefile.mk
+
 
+
-> MAYBE NOT: ''not build libxine if defined QUARTZ (maybe MACOSX ?) -> just adding a dummy rule in the makefile''
+
 
+
-> Quicktime will not be able to play all windows .avi and .wma files, because it does not support them. We may need xine or some other player backend to see some of the OOo documents created on Windows OOo.
+
 
+
avmedia/prj/build.lst
+
 
+
-> add new part avmedia/source/macosx to be built
+
 
+
Space naming convention :
+
 
+
NO: ''Use aqua for the new classes, and AquaPlayer as prefix for everything.''
+
<code>
+
  This is not good. Use '''Quicktime''' or '''QT''' for all things, also for directory and files:
+
  '''avmedia/source/quicktime/'''... Why? Because Quicktime can be used also on Windows! (remember iTunes?)
+
  And this is not Aqua technology. There is no reason to "brand" this as Mac OS X thing, when also other
+
  platforms can use it.
+
</code>
+
  
 +
===STATUS===
  
 
- create manager ( using UNO services)  [ done ]
 
- create manager ( using UNO services)  [ done ]
Line 83: Line 41:
 
  Missing (to be adapted for QuickTime) :
 
  Missing (to be adapted for QuickTime) :
  
  using avmedia::aqua::  
+
  using avmedia::quicktime::  
  
 
  Player::Player()    // Ctor
 
  Player::Player()    // Ctor
Line 90: Line 48:
 
  const Player::getVideoWindow()
 
  const Player::getVideoWindow()
 
  void Player::setNotifyWnd()
 
  void Player::setNotifyWnd()
  void Player::setDDrawParams()
+
  void Player::setDDrawParams() // maybe not needed
 
  long Player::processEvent()
 
  long Player::processEvent()
 
  void Player::start()
 
  void Player::start()
Line 111: Line 69:
 
  [FIXME] Other methods to be implemented ?
 
  [FIXME] Other methods to be implemented ?
  
Done (using existing Windows implementation) :
 
- all headers are defined
 
- usefull functions are identifed in Apple's API
 
  
  Found in System/Library/Framework/QuickTime.framework/Headers/Movies.h :
+
- all headers are defined [ Done (using existing Xine/Win implementation) ]
 +
- usefull functions are identifed in Apple's API
 +
 
 +
Found in System/Library/Framework/QuickTime.framework/Headers/Movies.h :
  
 
  '''DisposeMovie()'''
 
  '''DisposeMovie()'''

Revision as of 08:27, 19 September 2006

Contributors

  • Mox Soini: Mox
  • Eric Bachard (ericb at openoffice dot org )

Introduction

As part of native OpenOffice.org for Mac OS X, a Quicktime backend for avmedia module will be created, to support native audio and video on Mac OS X. Although this implementation concentrates on Mac OS X, it should be possible to make Quicktime backend work on Windows-platform too.

This approach was agreed with the author of avmedia module (Kai Ahrens, Kai's Mail).

Tasks

OOo scope: avmedia module

Initial structure for the quicktime backend has been put up to issue 69665. It is based on the stub of Xine -backend, OOo milestone m184.

EricB made also some initial modifications, but they use different naming conventions.


Related issues: Quicktime will not be able to play all windows .avi and .wma files, because it does not support them. We may need xine or some other player backend to see some of the OOo documents created on Windows OOo.

For other backends, make sure that we don't build backends that we don't need (i.e. if defined QUARTZ/MACOSX)

affected files (at least): avmedia/source/xine/makefile.mk

STATUS

- create manager ( using UNO services) [ done ]

- create uno layer [ done ]
- implement correct service name / implementation name using UNO  [ work in progress ]
- create player (using QuickTime API)  [ work in progress ]
 
Missing (to be adapted for QuickTime) :
using avmedia::quicktime:: 
Player::Player()    // Ctor
Player::~PLayer() // Dtor
bool Player::create()
const Player::getVideoWindow()
void Player::setNotifyWnd()
void Player::setDDrawParams()  // maybe not needed
long Player::processEvent()
void Player::start()
void Player::stop()
sal_Bool Player::isPlaying()
double Player::getDuration()
void Player::setMediaTime()
double Player::getMediaTime()
void Player::setStopTime()
double Player::getStopTime()
void Player::setRate()
void Player::getRate()
void Player::setPlaybackLoop()
void Player::isPlaybackLoop()
void Player::setMute()
sal_Bool Player::isMute()
void Player::setVolumeDB()
sal_Int16 Player::getVolumeDB()

[FIXME] Other methods to be implemented ?


- all headers are defined [ Done (using existing Xine/Win implementation) ] - usefull functions are identifed in Apple's API

Found in System/Library/Framework/QuickTime.framework/Headers/Movies.h :

DisposeMovie()
Frees any memory being used by a movie, including the memory used by the movie's tracks and media structures.
EnterMovies()
Initializes the Movie Toolbox and creates a private storage area for your application.
GetMovieDuration()
Returns the duration of a movie.
GetMovieRate()
Returns a movie's playback rate.
GetMovieTime
Returns a movie's current time both as a time value and in a time structure. 
GetMovieVolume
Returns a movie's current volume setting.
IsMovieDone
Determines if a particular movie has completely finished playing.
SetMovieGWorld
Establishes a movie's display coordinate system by setting the graphics world for displaying the movie.

[FIXME] not complete


[To be continued]

Other work in progress :

- discuss with ka about new implementation and fix dark points
- new implementation of  -already defined- methods used in the player

Todo : find infos about framegrabber.cxx ?

Component Context

[FIXME]

Component Design

[FIXME]

Kai's Mail

Work started discussing with Kai Ahrens (author of avmedia). As adviced by Kai we will reuse Windows implementation (copied/pasted from Kai's mail):

"... Beside the 'common' avmedia part, that is the same on all platforms and used from the high level application side, there are several backend (actually two, one for Windows and one for JMF backends) implementations already realized or to be realized like a Xine, GStreamer etc. backend..."

"...What you did so far, is absolutely the right way. Taking the existing Windows implementation and fill it with the appropriate Quicktime or whatever pieces. After finishing your new backend you should adjust the code in MediaWindowBaseImpl::createPlayer (avmedia/source/viewer/mediawindowbase_impl.cxx) accordingly to get your new component initialized instead of the existing ones.

Having a 'status' struct is already realized within mediawindowbase_impl.cxx and the corresponding methods MediaWindowBaseImpl::updateMediaItem and MediaWindowBaseImpl::executeMediaItem , I think, but maybe I didn't get you right here.

Please feel free to ask if you have any detailed questions.

With best regards,

Kai"

Personal tools