xref: /aosp_15_r20/external/skia/relnotes/precompilecontext.md (revision c8dee2aa9b3f27cf6c858bd81872bdeb2c07ed17)
1
2A new PrecompileContext object has been added to assist Precompilation. The old API of the form:\
3    bool Precompile(Context*, ...);\
4has been deprecated and replaced with the API:\
5    bool Precompile(PrecompileContext*, ...)\
6The new PrecompileContext object can be obtained via the Context::makePrecompileContext call.
7
8As an example of a possible Compilation/Precompilation threading model, one could employ 4 threads:
9
102 for creating Recordings (\<r1\> and \<r2\>) \
111 for precompiling (\<p1\>) \
12and the main thread - which owns the Context and submits Recordings.
13
14Start up for this scenario would look like:
15
16  the main thread moves a PrecompileContext to <p1> and begins precompiling there\
17  the main thread creates two Recorders and moves them to <r1> and <r2> to create Recordings\
18  the main thread continues on - calling Context::insertRecording on the posted Recordings.
19
20The PrecompileContext can safely outlive the Context that created it, but it will
21effectively be shut down at that point.
22