[prev in list] [next in list] [prev in thread] [next in thread]
List: koffice-devel
Subject: Re: Updated kpresenter dbus slideshow control patch
From: "Jos Poortvliet" <jospoortvliet () gmail ! com>
Date: 2008-10-25 12:23:20
Message-ID: 5847e5cf0810250523o29fe08fbk6458c09c0e3a6789 () mail ! gmail ! com
[Download RAW message or body]
[Attachment #2 (multipart/alternative)]
On Thu, Oct 23, 2008 at 8:17 PM, James Hogan <james@albanarts.com> wrote:
> Hi
>
> I've attached an updated patch implementing a dbus interface for
> controlling
> slideshows from programs such as kworship.
I can't say anything about the technical details here, but: do we actually
have an app called kworship or is this a spellingerror?
> It is based off koffice 2.0 beta-2.
> Sorry it took so long for me to get around to updating it.
>
> Thorsten: I'd really appreciate if you could take another look and let me
> know
> if there are any more problems and if you approve of the use of dbus
> signals.
> Email me if you have any more questions.
>
> Rough changes since previous patch:
>
> * generally tidied up, style fixes
> * removed the dbus method for showing edit custom slideshow dialog as it is
> unnecessary and not the best way of doing it anyway.
> * view adaptor doesn't use KPrAnimationDirector directly, instead
> interfacing
> through KPrViewModePresentation
> * added pageNotes dbus method to get slide notes in plain text or html
> * added exportPageThumbnail dbus method to save a thumbnail to file
> (adapted
> from koffice 1.6.3)
> * added documentOpened and documentClosed dbus signals to application
>
> overall dbus interface additions:
>
> These signals apply to all koffice applications and allow a controlling
> program to know when it needs to modify its list of open documents. Without
> these I imagine a controller would have to poll for changes to the document
> list or the user would have to manually refresh the list when they wanted
> to
> control a newly opened document.
> * KoApplicationAdaptor::documentOpened(QString dbus_ref) signal is emitted
> when a document is opened (and its first view created).
> * KoApplicationAdaptor::documentClosed(QString dbus_ref) signal is emitted
> when a document is closed (its last view destroyed).
>
> The following methods/signals are in a new adaptor KPrViewAdaptor
> (org.kde.koffice.presentation.view)
>
> Custom slideshows - this basically allows a controlling program to show a
> list
> of custom slideshows, keep it up to date and synchronised, and change the
> active custom slideshow ready for starting a presentation.
> * QStringList customSlideShows() - returns a list of custom slideshow names
> * QString activeCustomSlideShow() - returns the current custom slideshow
> name
> * void setActiveCustomSlideShow(QString) - sets the current custom
> slideshow
> * signal activeCustomSlideShowChanged(QString) - emitted when the active
> custom slideshow is changed
> * signal customSlideShowsModified() - emitted when the custom slideshows
> have
> been edited and the controller needs to update its list
>
> slide information. These allow the controlling program to list the slides
> in
> the active slideshow (with thumbnails) and show slide notes during
> presentations
> * int numCustomSlideShowSlides() - returns the number of slides in the
> active
> custom slideshow
> * QString pageNotes(int page, QString format) - returns the notes for a
> given
> page in the active slideshow (format can be "plain" or "html")
> * bool exportPageThumbnail(int page, ...) - saves a thumbnail of a slide in
> the active custom slideshow to an image file.
>
> presentation control methods. these allow navigation of the running
> presentation and are pretty much self explanatory
> * presentationStart()
> * presentationStartFromFirst()
> * presentationStop()
> * presentationPrev() - previous step
> * presentationNext() - next step
> * presentationPrevSlide()
> * presentationFirst()
> * presentationLast()
> * gotoPresentationPage(int)
>
> presentation accessors - the current state of the presentation can be
> accessed
> for feedback to the user from the controller gui
> * bool isPresentationRunning()
> * int currentPresentationPage()
> * int currentPresentationStep()
> * int numStepsInPresentationPage()
> * int numPresentationPages()
>
> presentation signals - allow the controller gui to be kept up to date when
> the
> presentation state changes not as a result of an action by the controller
> (e.g. timed transitions)
> * presentationStarted(int numSlides)
> * presentationStopped()
> * presentationPageChanged(int page, int stepsInPage)
> * presentationStepChanged(int step)
>
> Cheers
>
> --
> James Hogan
>
> _______________________________________________
> koffice-devel mailing list
> koffice-devel@kde.org
> https://mail.kde.org/mailman/listinfo/koffice-devel
>
>
[Attachment #5 (text/html)]
<br><br><div class="gmail_quote">On Thu, Oct 23, 2008 at 8:17 PM, James Hogan <span \
dir="ltr"><<a href="mailto:james@albanarts.com">james@albanarts.com</a>></span> \
wrote:<br><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, \
204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;"> Hi<br>
<br>
I've attached an updated patch implementing a dbus interface for controlling<br>
slideshows from programs such as kworship. </blockquote><div><br>I can't say \
anything about the technical details here, but: do we actually have an app called \
kworship or is this a spellingerror?<br><br> </div><blockquote \
class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt \
0pt 0.8ex; padding-left: 1ex;"> It is based off koffice 2.0 beta-2.<br>
Sorry it took so long for me to get around to updating it.<br>
<br>
Thorsten: I'd really appreciate if you could take another look and let me \
know<br> if there are any more problems and if you approve of the use of dbus \
signals.<br> Email me if you have any more questions.<br>
<br>
Rough changes since previous patch:<br>
<br>
* generally tidied up, style fixes<br>
* removed the dbus method for showing edit custom slideshow dialog as it is<br>
unnecessary and not the best way of doing it anyway.<br>
* view adaptor doesn't use KPrAnimationDirector directly, instead interfacing<br>
through KPrViewModePresentation<br>
* added pageNotes dbus method to get slide notes in plain text or html<br>
* added exportPageThumbnail dbus method to save a thumbnail to file (adapted<br>
from koffice 1.6.3)<br>
* added documentOpened and documentClosed dbus signals to application<br>
<br>
overall dbus interface additions:<br>
<br>
These signals apply to all koffice applications and allow a controlling<br>
program to know when it needs to modify its list of open documents. Without<br>
these I imagine a controller would have to poll for changes to the document<br>
list or the user would have to manually refresh the list when they wanted to<br>
control a newly opened document.<br>
* KoApplicationAdaptor::documentOpened(QString dbus_ref) signal is emitted<br>
when a document is opened (and its first view created).<br>
* KoApplicationAdaptor::documentClosed(QString dbus_ref) signal is emitted<br>
when a document is closed (its last view destroyed).<br>
<br>
The following methods/signals are in a new adaptor KPrViewAdaptor<br>
(org.kde.koffice.presentation.view)<br>
<br>
Custom slideshows - this basically allows a controlling program to show a list<br>
of custom slideshows, keep it up to date and synchronised, and change the<br>
active custom slideshow ready for starting a presentation.<br>
* QStringList customSlideShows() - returns a list of custom slideshow names<br>
* QString activeCustomSlideShow() - returns the current custom slideshow name<br>
* void setActiveCustomSlideShow(QString) - sets the current custom slideshow<br>
* signal activeCustomSlideShowChanged(QString) - emitted when the active<br>
custom slideshow is changed<br>
* signal customSlideShowsModified() - emitted when the custom slideshows have<br>
been edited and the controller needs to update its list<br>
<br>
slide information. These allow the controlling program to list the slides in<br>
the active slideshow (with thumbnails) and show slide notes during<br>
presentations<br>
* int numCustomSlideShowSlides() - returns the number of slides in the active<br>
custom slideshow<br>
* QString pageNotes(int page, QString format) - returns the notes for a given<br>
page in the active slideshow (format can be "plain" or \
"html")<br>
* bool exportPageThumbnail(int page, ...) - saves a thumbnail of a slide in<br>
the active custom slideshow to an image file.<br>
<br>
presentation control methods. these allow navigation of the running<br>
presentation and are pretty much self explanatory<br>
* presentationStart()<br>
* presentationStartFromFirst()<br>
* presentationStop()<br>
* presentationPrev() - previous step<br>
* presentationNext() - next step<br>
* presentationPrevSlide()<br>
* presentationFirst()<br>
* presentationLast()<br>
* gotoPresentationPage(int)<br>
<br>
presentation accessors - the current state of the presentation can be accessed<br>
for feedback to the user from the controller gui<br>
* bool isPresentationRunning()<br>
* int currentPresentationPage()<br>
* int currentPresentationStep()<br>
* int numStepsInPresentationPage()<br>
* int numPresentationPages()<br>
<br>
presentation signals - allow the controller gui to be kept up to date when the<br>
presentation state changes not as a result of an action by the controller<br>
(e.g. timed transitions)<br>
* presentationStarted(int numSlides)<br>
* presentationStopped()<br>
* presentationPageChanged(int page, int stepsInPage)<br>
* presentationStepChanged(int step)<br>
<br>
Cheers<br>
<br>
--<br>
<font color="#888888">James Hogan<br>
</font><br>_______________________________________________<br>
koffice-devel mailing list<br>
<a href="mailto:koffice-devel@kde.org">koffice-devel@kde.org</a><br>
<a href="https://mail.kde.org/mailman/listinfo/koffice-devel" \
target="_blank">https://mail.kde.org/mailman/listinfo/koffice-devel</a><br> \
<br></blockquote></div><br>
_______________________________________________
koffice-devel mailing list
koffice-devel@kde.org
https://mail.kde.org/mailman/listinfo/koffice-devel
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic