3 # ***** BEGIN GPL LICENSE BLOCK *****
5 # This program is free software; you can redistribute it and/or
6 # modify it under the terms of the GNU General Public License
7 # as published by the Free Software Foundation; either version 2
8 # of the License, or (at your option) any later version.
10 # This program is distributed in the hope that it will be useful,
11 # but WITHOUT ANY WARRANTY; without even the implied warranty of
12 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 # GNU General Public License for more details.
15 # You should have received a copy of the GNU General Public License
16 # along with this program; if not, write to the Free Software Foundation,
17 # Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
19 # The Original Code is Copyright (C) 2006, Blender Foundation
20 # All rights reserved.
22 # The Original Code is: all of this file.
24 # Contributor(s): Nathan Letwory.
26 # ***** END GPL LICENSE BLOCK *****
28 # Main entry-point for the SCons building system
29 # Set up some custom actions and target/argument handling
30 # Then read all SConscripts and build
39 from tempfile import mkdtemp
45 EnsureSConsVersion(1,0,0)
47 BlenderEnvironment = tools.Blender.BlenderEnvironment
52 platform = sys.platform
57 ##### BEGIN SETUP #####
59 B.possible_types = ['core', 'common', 'blender', 'intern',
60 'international', 'game', 'game2',
61 'player', 'player2', 'system']
63 B.binarykind = ['blender' , 'blenderplayer']
64 ##################################
65 # target and argument validation #
66 ##################################
67 # XX cheating for BF_FANCY, we check for BF_FANCY before args are validated
68 use_color = ARGUMENTS.get('BF_FANCY', '1')
72 if not use_color=='1':
75 #on defaut white Os X terminal, some colors are totally unlegible
76 if platform=='darwin':
77 B.bc.OKGREEN = '\033[34m'
78 B.bc.WARNING = '\033[36m'
81 print B.bc.HEADER+'Command-line arguments'+B.bc.ENDC
82 B.arguments = btools.validate_arguments(ARGUMENTS, B.bc)
83 btools.print_arguments(B.arguments, B.bc)
86 print B.bc.HEADER+'Command-line targets'+B.bc.ENDC
87 B.targets = btools.validate_targets(COMMAND_LINE_TARGETS, B.bc)
88 btools.print_targets(B.targets, B.bc)
90 ##########################
91 # setting up environment #
92 ##########################
94 # handling cmd line arguments & config file
96 # first check cmdline for toolset and we create env to work on
97 quickie = B.arguments.get('BF_QUICK', None)
98 quickdebug = B.arguments.get('BF_QUICKDEBUG', None)
101 B.quickdebug=string.split(quickdebug, ',')
106 B.quickie=string.split(quickie,',')
110 toolset = B.arguments.get('BF_TOOLSET', None)
112 print "Using " + toolset
113 if toolset=='mstoolkit':
114 env = BlenderEnvironment(ENV = os.environ)
115 env.Tool('mstoolkit', ['tools'])
117 env = BlenderEnvironment(tools=[toolset], ENV = os.environ)
119 btools.SetupSpawn(env)
121 env = BlenderEnvironment(ENV = os.environ)
124 print "Could not create a build environment"
128 cc = B.arguments.get('CC', None)
129 cxx = B.arguments.get('CXX', None)
135 if env['CC'] in ['cl', 'cl.exe'] and sys.platform=='win32':
136 platform = 'win32-vc'
137 elif env['CC'] in ['gcc'] and sys.platform=='win32':
138 platform = 'win32-mingw'
140 env.SConscriptChdir(0)
142 crossbuild = B.arguments.get('BF_CROSS', None)
143 if crossbuild and platform!='win32':
144 platform = 'linuxcross'
146 env['OURPLATFORM'] = platform
148 configfile = 'config'+os.sep+platform+'-config.py'
150 if os.path.exists(configfile):
151 print B.bc.OKGREEN + "Using config file: " + B.bc.ENDC + configfile
153 print B.bc.FAIL + configfile + " doesn't exist" + B.bc.ENDC
155 if crossbuild and env['PLATFORM'] != 'win32':
156 print B.bc.HEADER+"Preparing for crossbuild"+B.bc.ENDC
157 env.Tool('crossmingw', ['tools'])
158 # todo: determine proper libs/includes etc.
159 # Needed for gui programs, console programs should do without it
160 env.Append(LINKFLAGS=['-mwindows'])
162 userconfig = B.arguments.get('BF_CONFIG', 'user-config.py')
163 # first read platform config. B.arguments will override
164 optfiles = [configfile]
165 if os.path.exists(userconfig):
166 print B.bc.OKGREEN + "Using user-config file: " + B.bc.ENDC + userconfig
167 optfiles += [userconfig]
169 print B.bc.WARNING + userconfig + " not found, no user overrides" + B.bc.ENDC
171 opts = btools.read_opts(optfiles, B.arguments)
174 if not env['BF_FANCY']:
177 SetOption('num_jobs', int(env['BF_NUMJOBS']))
178 print "Build with %d parallel jobs" % (GetOption('num_jobs'))
180 # disable elbeem (fluidsim) compilation?
181 if env['BF_NO_ELBEEM'] == 1:
182 env['CPPFLAGS'].append('-DDISABLE_ELBEEM')
183 env['CXXFLAGS'].append('-DDISABLE_ELBEEM')
184 env['CCFLAGS'].append('-DDISABLE_ELBEEM')
186 if env['WITH_BF_OPENMP'] == 1:
187 if env['OURPLATFORM']=='win32-vc':
188 env['CCFLAGS'].append('/openmp')
189 env['CPPFLAGS'].append('/openmp')
190 env['CXXFLAGS'].append('/openmp')
192 if env['CC'][-3:] == 'icc': # to be able to handle CC=/opt/bla/icc case
193 env.Append(LINKFLAGS=['-openmp', '-static-intel'])
194 env['CCFLAGS'].append('-openmp')
195 env['CPPFLAGS'].append('-openmp')
196 env['CXXFLAGS'].append('-openmp')
198 env.Append(CCFLAGS=['-fopenmp'])
199 env.Append(CPPFLAGS=['-fopenmp'])
200 env.Append(CXXFLAGS=['-fopenmp'])
201 # env.Append(LINKFLAGS=['-fprofile-generate'])
203 #check for additional debug libnames
205 if env.has_key('BF_DEBUG_LIBS'):
206 B.quickdebug += env['BF_DEBUG_LIBS']
208 printdebug = B.arguments.get('BF_LISTDEBUG', 0)
210 # see if this linux distro has libalut
212 if env['OURPLATFORM'] == 'linux2' :
213 if env['WITH_BF_OPENAL']:
214 mylib_test_source_file = """
216 int main(int argc, char **argv)
218 alutGetMajorVersion();
223 def CheckFreeAlut(context,env):
224 context.Message( B.bc.OKGREEN + "Linux platform detected:\n checking for FreeAlut... " + B.bc.ENDC )
226 result = context.TryLink(mylib_test_source_file, '.c')
227 context.Result(result)
230 env2 = env.Clone( LIBPATH = env['BF_OPENAL'] )
231 sconf_temp = mkdtemp()
232 conf = Configure( env2, {'CheckFreeAlut' : CheckFreeAlut}, sconf_temp, '/dev/null' )
233 if conf.CheckFreeAlut( env2 ):
234 env['BF_OPENAL_LIB'] += ' alut'
237 for root, dirs, files in os.walk(sconf_temp, topdown=False):
239 os.remove(os.path.join(root, name))
241 os.rmdir(os.path.join(root, name))
242 if root: os.rmdir(root)
244 if len(B.quickdebug) > 0 and printdebug != 0:
245 print B.bc.OKGREEN + "Buildings these libs with debug symbols:" + B.bc.ENDC
246 for l in B.quickdebug:
249 # remove stdc++ from LLIBS if we are building a statc linked CXXFLAGS
250 if env['WITH_BF_STATICCXX']:
251 if 'stdc++' in env['LLIBS']:
252 env['LLIBS'] = env['LLIBS'].replace('stdc++', ' ')
254 print '\tcould not remove stdc++ library from LLIBS, WITH_BF_STATICCXX may not work for your platform'
256 # check target for blenderplayer. Set WITH_BF_PLAYER if found on cmdline
257 if 'blenderplayer' in B.targets:
258 env['WITH_BF_PLAYER'] = True
260 if 'blendernogame' in B.targets:
261 env['WITH_BF_GAMEENGINE'] = False
263 if 'blenderlite' in B.targets:
264 env['WITH_BF_GAMEENGINE'] = False
265 env['WITH_BF_OPENAL'] = False
266 env['WITH_BF_OPENEXR'] = False
267 env['WITH_BF_ICONV'] = False
268 env['WITH_BF_INTERNATIONAL'] = False
269 env['WITH_BF_OPENJPEG'] = False
270 env['WITH_BF_FFMPEG'] = False
271 env['WITH_BF_QUICKTIME'] = False
272 env['WITH_BF_YAFRAY'] = False
273 env['WITH_BF_REDCODE'] = False
274 env['WITH_BF_FTGL'] = False
275 env['WITH_BF_DDS'] = False
276 env['WITH_BF_ZLIB'] = False
277 env['WITH_BF_SDL'] = False
278 env['WITH_BF_JPEG'] = False
279 env['WITH_BF_PNG'] = False
280 env['WITH_BF_ODE'] = False
281 env['WITH_BF_BULLET'] = False
282 env['WITH_BF_BINRELOC'] = False
283 env['BF_BUILDINFO'] = False
284 env['BF_NO_ELBEEM'] = True
285 env['WITH_BF_PYTHON'] = False
287 # lastly we check for root_build_dir ( we should not do before, otherwise we might do wrong builddir
288 #B.root_build_dir = B.arguments.get('BF_BUILDDIR', '..'+os.sep+'build'+os.sep+platform+os.sep)
289 B.root_build_dir = env['BF_BUILDDIR']
290 B.doc_build_dir = env['BF_DOCDIR']
291 if not B.root_build_dir[-1]==os.sep:
292 B.root_build_dir += os.sep
293 if not B.doc_build_dir[-1]==os.sep:
294 B.doc_build_dir += os.sep
296 # We do a shortcut for clean when no quicklist is given: just delete
297 # builddir without reading in SConscripts
299 if 'clean' in B.targets:
302 if not quickie and do_clean:
303 if os.path.exists(B.doc_build_dir):
304 print B.bc.HEADER+'Cleaning doc dir...'+B.bc.ENDC
305 dirs = os.listdir(B.doc_build_dir)
307 if os.path.isdir(B.doc_build_dir + entry) == 1:
308 print "clean dir %s"%(B.doc_build_dir+entry)
309 shutil.rmtree(B.doc_build_dir+entry)
311 print "remove file %s"%(B.doc_build_dir+entry)
312 os.remove(B.root_build_dir+entry)
313 if os.path.exists(B.root_build_dir):
314 print B.bc.HEADER+'Cleaning build dir...'+B.bc.ENDC
315 dirs = os.listdir(B.root_build_dir)
317 if os.path.isdir(B.root_build_dir + entry) == 1:
318 print "clean dir %s"%(B.root_build_dir+entry)
319 shutil.rmtree(B.root_build_dir+entry)
321 print "remove file %s"%(B.root_build_dir+entry)
322 os.remove(B.root_build_dir+entry)
323 for confile in ['extern/ffmpeg/config.mak', 'extern/x264/config.mak',
324 'extern/xvidcore/build/generic/platform.inc']:
325 if os.path.exists(confile):
326 print "clean file %s"%confile
328 print B.bc.OKGREEN+'...done'+B.bc.ENDC
330 print B.bc.HEADER+'Already Clean, nothing to do.'+B.bc.ENDC
333 if not os.path.isdir ( B.root_build_dir):
334 os.makedirs ( B.root_build_dir )
335 os.makedirs ( B.root_build_dir + 'source' )
336 os.makedirs ( B.root_build_dir + 'intern' )
337 os.makedirs ( B.root_build_dir + 'extern' )
338 os.makedirs ( B.root_build_dir + 'lib' )
339 os.makedirs ( B.root_build_dir + 'bin' )
340 if not os.path.isdir(B.doc_build_dir):
341 os.makedirs ( B.doc_build_dir )
343 Help(opts.GenerateHelpText(env))
345 # default is new quieter output, but if you need to see the
346 # commands, do 'scons BF_QUIET=0'
347 bf_quietoutput = B.arguments.get('BF_QUIET', '1')
349 B.set_quiet_output(env)
354 print B.bc.HEADER+'Building in '+B.bc.ENDC+B.root_build_dir
355 env.SConsignFile(B.root_build_dir+'scons-signatures')
358 ##### END SETUP ##########
362 BuildDir(B.root_build_dir+'/intern', 'intern', duplicate=0)
363 SConscript(B.root_build_dir+'/intern/SConscript')
364 BuildDir(B.root_build_dir+'/extern', 'extern', duplicate=0)
365 SConscript(B.root_build_dir+'/extern/SConscript')
366 BuildDir(B.root_build_dir+'/source', 'source', duplicate=0)
367 SConscript(B.root_build_dir+'/source/SConscript')
369 # now that we have read all SConscripts, we know what
370 # libraries will be built. Create list of
371 # libraries to give as objects to linking phase
373 for tp in B.possible_types:
374 if not tp == 'player' and not tp == 'player2':
375 mainlist += B.create_blender_liblist(env, tp)
377 if B.arguments.get('BF_PRIORITYLIST', '0')=='1':
378 B.propose_priorities()
380 dobj = B.buildinfo(env, "dynamic") + B.resources
381 thestatlibs, thelibincs = B.setup_staticlibs(env)
382 thesyslibs = B.setup_syslibs(env)
384 if 'blender' in B.targets or not env['WITH_BF_NOBLENDER']:
385 env.BlenderProg(B.root_build_dir, "blender", dobj + mainlist + thestatlibs, [], thesyslibs, [B.root_build_dir+'/lib'] + thelibincs, 'blender')
386 if env['WITH_BF_PLAYER']:
387 playerlist = B.create_blender_liblist(env, 'player')
388 env.BlenderProg(B.root_build_dir, "blenderplayer", dobj + playerlist + thestatlibs, [], thesyslibs, [B.root_build_dir+'/lib'] + thelibincs, 'blenderplayer')
390 ##### Now define some targets
393 #------------ INSTALL
397 if env['OURPLATFORM']=='darwin':
398 for prg in B.program_list:
399 bundle = '%s.app' % prg[0]
400 bundledir = os.path.dirname(bundle)
401 for dp, dn, df in os.walk(bundle):
406 dir=env['BF_INSTALLDIR']+dp[len(bundledir):]
407 source=[dp+os.sep+f for f in df]
408 blenderinstall.append(env.Install(dir=dir,source=source))
410 blenderinstall = env.Install(dir=env['BF_INSTALLDIR'], source=B.program_list)
413 #- dont do .blender and scripts for darwin, it is already in the bundle
418 if env['OURPLATFORM']!='darwin':
419 for dp, dn, df in os.walk('bin/.blender'):
425 dotblendlist.append(dp+os.sep+f)
426 dottargetlist.append(env['BF_INSTALLDIR']+dp[3:]+os.sep+f)
428 dotblenderinstall = []
429 for targetdir,srcfile in zip(dottargetlist, dotblendlist):
430 td, tf = os.path.split(targetdir)
431 dotblenderinstall.append(env.Install(dir=td, source=srcfile))
434 scriptpath='release/scripts'
435 for dp, dn, df in os.walk(scriptpath):
440 dir=env['BF_INSTALLDIR']+'/.blender/scripts'+dp[len(scriptpath):]
441 source=[dp+os.sep+f for f in df]
442 scriptinstall.append(env.Install(dir=dir,source=source))
445 if env['OURPLATFORM']=='linux2':
449 for tp, tn, tf in os.walk('release/freedesktop/icons'):
455 print ">>>", env['BF_INSTALLDIR'], tp, f
456 iconlist.append(tp+os.sep+f)
457 icontargetlist.append(env['BF_INSTALLDIR']+tp[19:]+os.sep+f)
460 for targetdir,srcfile in zip(icontargetlist, iconlist):
461 td, tf = os.path.split(targetdir)
462 iconinstall.append(env.Install(dir=td, source=srcfile))
467 for tp, tn, tf in os.walk('release/plugins'):
473 print ">>>", env['BF_INSTALLDIR'], tp, f
474 pluglist.append(tp+os.sep+f)
475 plugtargetlist.append(env['BF_INSTALLDIR']+tp[7:]+os.sep+f)
477 # header files for plugins
478 pluglist.append('source/blender/blenpluginapi/documentation.h')
479 plugtargetlist.append(env['BF_INSTALLDIR'] + os.sep + 'plugins' + os.sep + 'include' + os.sep +'documentation.h')
480 pluglist.append('source/blender/blenpluginapi/externdef.h')
481 plugtargetlist.append(env['BF_INSTALLDIR'] + os.sep + 'plugins' + os.sep + 'include' + os.sep +'externdef.h')
482 pluglist.append('source/blender/blenpluginapi/floatpatch.h')
483 plugtargetlist.append(env['BF_INSTALLDIR'] + os.sep + 'plugins' + os.sep + 'include' + os.sep +'floatpatch.h')
484 pluglist.append('source/blender/blenpluginapi/iff.h')
485 plugtargetlist.append(env['BF_INSTALLDIR'] + os.sep + 'plugins' + os.sep + 'include' + os.sep +'iff.h')
486 pluglist.append('source/blender/blenpluginapi/plugin.h')
487 plugtargetlist.append(env['BF_INSTALLDIR'] + os.sep + 'plugins' + os.sep + 'include' + os.sep +'plugin.h')
488 pluglist.append('source/blender/blenpluginapi/util.h')
489 plugtargetlist.append(env['BF_INSTALLDIR'] + os.sep + 'plugins' + os.sep + 'include' + os.sep +'util.h')
490 pluglist.append('source/blender/blenpluginapi/plugin.DEF')
491 plugtargetlist.append(env['BF_INSTALLDIR'] + os.sep + 'plugins' + os.sep + 'include' + os.sep + 'plugin.def')
494 for targetdir,srcfile in zip(plugtargetlist, pluglist):
495 td, tf = os.path.split(targetdir)
496 plugininstall.append(env.Install(dir=td, source=srcfile))
500 for tp, tn, tf in os.walk('release/text'):
506 textlist.append(tp+os.sep+f)
508 textinstall = env.Install(dir=env['BF_INSTALLDIR'], source=textlist)
510 if env['OURPLATFORM']=='darwin':
511 allinstall = [blenderinstall, plugininstall, textinstall]
512 elif env['OURPLATFORM']=='linux2':
513 allinstall = [blenderinstall, dotblenderinstall, scriptinstall, plugininstall, textinstall, iconinstall]
515 allinstall = [blenderinstall, dotblenderinstall, scriptinstall, plugininstall, textinstall]
517 if env['OURPLATFORM'] in ('win32-vc', 'win32-mingw'):
518 dllsources = ['${LCGDIR}/gettext/lib/gnu_gettext.dll',
519 '${LCGDIR}/png/lib/libpng.dll',
520 '#release/windows/extra/zlib.pyd',
521 '${LCGDIR}/zlib/lib/zlib.dll',
522 '${LCGDIR}/tiff/lib/libtiff.dll']
523 if env['WITH_BF_SDL']:
524 dllsources.append('${LCGDIR}/sdl/lib/SDL.dll')
525 if env['WITH_BF_PYTHON']:
526 dllsources.append('#release/windows/extra/python25.zip')
528 dllsources.append('${LCGDIR}/python/lib/${BF_PYTHON_LIB}_d.dll')
530 dllsources.append('${LCGDIR}/python/lib/${BF_PYTHON_LIB}.dll')
531 if env['OURPLATFORM'] == 'win32-mingw':
532 dllsources += ['${LCGDIR}/pthreads/lib/pthreadGC2.dll']
534 dllsources += ['${LCGDIR}/pthreads/lib/pthreadVC2.dll']
535 if env['WITH_BF_ICONV']:
536 dllsources += ['${LCGDIR}/iconv/lib/iconv.dll']
537 if env['WITH_BF_FFMPEG']:
538 dllsources += ['${LCGDIR}/ffmpeg/lib/avcodec-51.dll',
539 '${LCGDIR}/ffmpeg/lib/avformat-52.dll',
540 '${LCGDIR}/ffmpeg/lib/avdevice-52.dll',
541 '${LCGDIR}/ffmpeg/lib/avutil-49.dll',
542 '${LCGDIR}/ffmpeg/lib/libfaad-0.dll',
543 '${LCGDIR}/ffmpeg/lib/libfaac-0.dll',
544 '${LCGDIR}/ffmpeg/lib/libmp3lame-0.dll',
545 '${LCGDIR}/ffmpeg/lib/libx264-59.dll',
546 '${LCGDIR}/ffmpeg/lib/xvidcore.dll',
547 '${LCGDIR}/ffmpeg/lib/swscale-0.dll']
548 windlls = env.Install(dir=env['BF_INSTALLDIR'], source = dllsources)
549 allinstall += windlls
551 installtarget = env.Alias('install', allinstall)
552 bininstalltarget = env.Alias('install-bin', blenderinstall)
554 nsisaction = env.Action(btools.NSIS_Installer, btools.NSIS_print)
555 nsiscmd = env.Command('nsisinstaller', None, nsisaction)
556 nsisalias = env.Alias('nsis', nsiscmd)
558 if 'blender' in B.targets:
559 blenderexe= env.Alias('blender', B.program_list)
560 Depends(blenderexe,installtarget)
562 if env['WITH_BF_PLAYER']:
563 blenderplayer = env.Alias('blenderplayer', B.program_list)
564 Depends(blenderplayer,installtarget)
566 if not env['WITH_BF_GAMEENGINE']:
567 blendernogame = env.Alias('blendernogame', B.program_list)
568 Depends(blendernogame,installtarget)
570 if 'blenderlite' in B.targets:
571 blenderlite = env.Alias('blenderlite', B.program_list)
572 Depends(blenderlite,installtarget)
574 Depends(nsiscmd, allinstall)
576 Default(B.program_list)
578 if not env['WITHOUT_BF_INSTALL']:
579 Default(installtarget)
581 #------------ RELEASE
582 # TODO: zipup the installation
584 #------------ BLENDERPLAYER
585 # TODO: build stubs and link into blenderplayer
588 if env['WITH_BF_DOCS']:
589 SConscript('source/blender/python/api2_2x/doc/SConscript')
590 SConscript('source/gameengine/PyDoc/SConscript')