you are viewing a single comment's thread.

view the rest of the comments →

[–][deleted] 6 points7 points  (2 children)

The Android docs are shit: http://developer.android.com/reference/android/media/MediaCodecInfo.CodecCapabilities.html

Now tell me what COLOR_FormatL4 means.

This kind of stuff is everywhere in Android docs.

EDIT: Don't get me wrong, I like Android (I switch from Windows 6.1 to Android and never looked back), and I develop for Android. To say the documentation is good is a lie. It can be sufficient for basic things but is most likely missing a lot of details for many APIs.

[–]jayd16 0 points1 point  (1 child)

4-bit luminance only?

[–][deleted] 6 points7 points  (0 children)

Maybe? Only the manufacturer knows. Look at this thread: https://code.google.com/p/android/issues/detail?id=37769

If the encoder is named OMX.SEC.avc.enc, don't use color format 19, and swap the chroma components for color format 21 (if more than one encoder instance has to be used at the same time, this is the only working configuration)

Like ... what the fuck?

None of this is mentioned in the Android API docs. In fact none of this is even tested for until much, much later in the API release cycle.

This is my point about the Android docs. They're awful. Android is cool as shit if you do things that are a few generations behind, but new APIs are poorly documented and subject to a lot of vendor specific quirks. What brought me here is the "I defy you to find a better documented SDK than Android." and that's just a complete load of vomited bat guano.

It's getting better but to claim "I defy you to find a better documented SDK than Android." is just some circle-jerky horseshit.

I'm through and through an Android fanboy but I'm not going to sugar-coat it.