1 2 3 4
5
6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37
38
39 40 41
42
43 /*!
44 * ======== Settings ========
45 * Global configuration settings for all Codec Engine packages
46 *
47 * This module provides high-level configuration settings for all
48 * Codec Engine packages.
49 *
50 * @a(Linking with Codec Engine Libraries)
51 *
52 * When linking an executable, this module's profile config param is
53 * used to select which libraries are used. See the {@link #profile}
54 * config param below. There are three typical use-cases.
55 *
56 * 1. Link with Codec Engine libraries of a specific profile. Add the
57 * following to your application cfg script.
58 *
59 * @p(code)
60 * // set all codec engine libraries to the given profile
61 * xdc.useModule('ti.sdo.ce.global.Settings').profile = "debug";
62 * @p
63 *
64 * 2. Link with Codec Engine libraries using the program's profile. Add
65 * the following to your application cfg script.
66 *
67 * @p(code)
68 * // use the program's profile
69 * var Program = xdc.useModule('xdc.cfg.Program');
70 * xdc.useModule('ti.sdo.ce.global.Settings').profile = Program.build.profile;
71 * @p
72 *
73 * 3. Specify a profile on a per-package basis.
74 *
75 * @p(code)
76 * // specify the profile for some select packages
77 * xdc.loadPackage('ti.sdo.ce').profile = "debug";
78 * xdc.loadPackage('ti.sdo.ce.video').profile = "debug";
79 * xdc.loadPackage('ti.sdo.ce.image').profile = "debug";
80 * xdc.loadPackage('ti.sdo.ce.speech').profile = "debug";
81 * xdc.loadPackage('ti.sdo.ce.audio').profile = "debug";
82 * @p
83 *
84 * Note that the third method above does not actually use the `profile`
85 * config param. It sets the package's profile config param directly.
86 *
87 * The default value for the `profile` config param is `release`.
88 * Thus, even when building your executable using a debug profile, the
89 * Codec Engine release libraries will be used. This helps to keep the
90 * executable size smaller when you want to debug the application code.
91 */
92 metaonly module Settings
93 {
94 /*!
95 * ======== profile ========
96 * Name the library profile to use at link time
97 *
98 * If the Codec Engine libraries have been built using the profile
99 * named by this config param, then these libraries will be used
100 * when linking the final executable. Otherwise, a substitute
101 * library will be used. For example, if this config param is set to
102 * debug but there are only release libraries available, then the
103 * release library is used.
104 */
105 config String profile = "release";
106 }
107 108 109 110
111