Skip to content

Commit 6e000f4

Browse files
committed
Added link to arch doc
1 parent 7a1d9bc commit 6e000f4

File tree

1 file changed

+17
-4
lines changed

1 file changed

+17
-4
lines changed

README.md

Lines changed: 17 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -18,16 +18,29 @@ However:
1818
- It's not intended as a demonstration of the proper way to do things.
1919
The code may handle edge cases poorly or not at all. Logging is often
2020
left enabled at a moderately verbose level.
21-
- It's not documented.
21+
- It's barely documented.
2222
- It's not part of the Android Open Source Project. We cannot accept
2323
contributions to Grafika, even if you have an AOSP CLA on file.
2424
- It's NOT AN OFFICIAL GOOGLE PRODUCT. It's just a bunch of stuff that
2525
got thrown together on company time and equipment.
2626
- It's generally just not supported.
2727

28-
There is some overlap with the code on http://www.bigflake.com/mediacodec/. The code there largely consists of "headless" CTS tests, which are designed to be robust, self-contained, and largely independent of the usual app lifecycle issues. Grafika is a conventional app, and makes an effort to handle app issues correctly (like not doing lots of work on the UI thread).
29-
30-
Features are added to Grafika as the need arises, often in response to developer complaints about correctness or performance problems in the platform (either to confirm that the problems exist, or demonstrate an approach that works).
28+
To some extent, Grafika can be treated as a companion to the
29+
[Android System-Level Graphics Architecture](http://source.android.com/devices/graphics/architecture.html)
30+
document. The doc explains the technology that the examples rely on, and uses some of
31+
Grafika's activities as examples. If you want to understand how the code here works, start
32+
by reading that.
33+
34+
There is some overlap with the code on http://www.bigflake.com/mediacodec/.
35+
The code there largely consists of "headless" CTS tests, which are designed
36+
to be robust, self-contained, and largely independent of the usual app
37+
lifecycle issues. Grafika is a conventional app, and makes an effort to
38+
handle app issues correctly (like not doing lots of work on the UI thread).
39+
40+
Features are added to Grafika as the need arises, often in response to
41+
developer complaints about correctness or performance problems in the
42+
platform (either to confirm that the problems exist, or demonstrate an
43+
approach that works).
3144

3245
There are two areas where some amount of care is taken:
3346
- Thread safety. It's really easy to get threads crossed in subtly dangerous ways when

0 commit comments

Comments
 (0)