Mailing Lists: Apple Mailing Lists
 Image of Mac OS face in stamp
Re: QT docs
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: QT docs

from email@hidden
on 9/22/01 3:34 AM, Kevin Marks at email@hidden wrote:

> The Qt-API list is a good place to point out documnetation
> shortcomings or anomalies too - I know the docs people (including the
> prolific Steve Gulie) read it and post there.

I'll point out an area that is undocumented. MovieImportIdle()
and friends. I'm assuming that these are the functions that one would
need to implement to enable a movie importer for progressive download
from the web.

It was introduced in QT 4 (according to the QT 5 reference), it's not
mentioned in the QT4 reference, the 4.1 docs or the 5.0 docs. There
doesn't seem to be any sample code that implements it either.

Undocumented friends include (some from QT 5):
MovieImportEstimateCompletionTime()
MovieImportGetDontBlock()
MovieImportGetLoadState() - there's a little app side doc in QT 4.1
MovieImportGetMaxLoadedTime()
MovieImportSetDontBlock()

I'll throw a few in from the Data Handler's also, as I'm not sure
how the responsibilities are divided up.

DataHGetDataAvailability()
DataHGetDataRate()
DataHPollRead()
DataHReadAsync()
DataHSetTimeHints()

I'm guessing that these were added specifically for streaming media.
There may be other functions that I haven't run across yet also.

The goal for me would be to support both progressive playback during file
download and indefinite playback of a HTTP stream for audio data.

There is one line in "What's new in QT 5" on page 8 "Access to Shoutcast
streams is now available." That implies that QT can handle it somehow,
but there are no details. Shoutcast is currently MP3 only, but
Icecast 2 (a shoutcast clone) supports Ogg Vorbis as well.

Of course I'm not just looking for reference documentation, but also
overview and issues discussion like the QT 4 Reference has. That
has 70 pages (including the function descriptions) on importing and
exporting. QT 5 Reference has a six page overview that does little more
than list the function names. To be fair, the QT 5 Reference has 46
pages of function reference.

In my question on exporter presets on Sept 13,2001 to this list, I
pointed out the lack of documentation on that feature. I did figure
that problem out, I had the resources right, but had forgotten to
change my ComponentDispatch file from ComponentError to ComponentCall
for the SetSettings and GetSettings calls. Two pages on that would
have saved me several hours.

Another little tidbit I've learned about that is't documented, and I've
not seen mentioned on this list are the avvd and avvc resources. They
seem to be used in codecs that can be used with AVI files.

Steve Nicolai



Visit the Apple Store online or at retail locations.
1-800-MY-APPLE

Contact Apple | Terms of Use | Privacy Policy

Copyright © 2011 Apple Inc. All rights reserved.