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