Blender-aid release October 2010 User manual
Contents
1. y Properties ColorZilla gt Web Developer gt 2 Depending on your OS start the run command Alt f2 on Ubuntu file yivar productions yfichars frankie blend ly Run in terminal Run with file D Show list of known applications ElHep O cancel 3 Press Paste 16 29 Blender aid user manual 4 Press Run blender will be started with the file depending on the configuration of your machine TE aT r Emer File view Rename file When pressing on rename file a popup will be shown asking you to enter the new filename new name for frankie blend frankie_momo blend Enter new name and press OK A screen will be displayed showing you what will be done 17 29 Blender aid user manual Re factoring Tasks Tile description state franci_test cerf volant blend Changs library reference frankie blend to fcankie_momo blend Created levelsiievel_nut blend Change library reference frankie blend to frankie momo blend Created Jovals minilevel_release_Domo blend Change library reference rankis blend to frankis momo blend Created levels level_1_nome blend Change library reference frankie blend to feankie_momo blend Created Jovels libraty blend Changs library reference rankie blend to fcankie_momo blend Created levels minilevel the Arena blend Change library reference frankie blend to feankie_momo blend Created lovels minil2. default location of the database 1 Open the file settings py 2 Change whatever you like 3 Save the settings 4 Restart the server pyc Technical dependencies Blender aid depends on the following software Optional PIL Python Imaging Library for thumbnail generation Python 2 6 or Python 3 1 Pysvn tested with version 1 7 2 can be downloaded from http pysvn tigris org Asubversion implementation 1 6 or 1 5 can be downloaded from http subversion apache org packages html It is advisable to install the dependencies using the packaging system of your OS Installation of pysvn can be hard task as building the sources depends on many other libraries and OS specific settings like the location of the site packages directory During installation via sources of this library on Ubuntu 10 10 and Python 3 1 the next additional packages also needed to be installed only during compilation libneon27 dev python3 cxx The site packages directory is different as mentioned in the INSTALL html of pysvn The location we used is usr lib python3 1 5 29 Blender aid user manual De installation To remove Blender aid just delete the directory where it is installed The only created file is var tmp sql1 bin or otherwise when changed in settings py 6 29 Blender aid user manual Functionality web base Please note that the screenshots inside the document can be from other versions than what you are using First conf
3. please test the result of the rename After a commit or rollback you will be show the production view 18 29 Blender aid user manual File view Move file When pressing on move file a popup will be shown asking you to enter the new location new location for chars frankie_testlevel blend levels Q cancel ox Enter new location and press OK A screen will be displayed showing you what will be done Tasks Tile description state chars ttankie_testlevel blend Move file chars frankie_testlevel blend to levels frankie_testlevel blend Created Press continue to perform these tasks or press cancel to return to the file view After continue the tasks will be performed and you will be asked to rollback or commit the changes Before you continue please test the result of the rename After a commit or rollback you will be show the production view 19 29 Blender aid user manual File view Basic tab The basic tab will display some basic information of the file When the file is a texture a thumbnail will be displayed For a blend file render information of the active scene will be shown When clicking on the image the image will be downloaded or opened in your browser depending your browser settings hud hudsheet png Mova fil OBasic References Dependancy viewer 20 29 Blender aid user manual File view Elements tab The elements tab is only visible for blend fi
4. will be show the production view 14 29 Blender aid user manual File view When clicking on a file in the production view you will get information about the file This section describes this lt lt productions Yo Frankie T Scones Missing links chars frankie blend M Rename file fpeasic SElements References Dependancy viewer scene sCfrank_logic startframe 1 endframe 5025 resolutior 640x480 output PNG separts 4 y parts 4 A file is show together with Local link location to the file on the local file system for quick opening of the file Rename Rename the file Move Move a file to another location in the production Next to this information 4 tabs are displayed Basic some basic information about the file Elements the elements inside a blender file References references between files Dependancy viewer advanced production reference viewer 15 29 Blender aid user manual File view Local link With local link it is possible to quickly open the file on your system Due to security reasons this has to be done using the following steps 1 Press other mouse button on the link and choose Copy Link Location Yo Frankie jwar productions yf chars frankie blend Move file Rename file OPO Dima F Open Link in New Window r Open Link in New Tab lements S Bookmark This Link logic k Save Link As rt Send Link Anen x
5. Blender aid user manual Blender aid release October 2010 User manual this document is part of a GPLv3 license 1 29 Blender aid user manual Table of Contents Introduction What is Blender ait What can you do with it How does it work When do you use it Features Visibility Refactoring Installation Configuration of settings Technical dependencies De installation Functionality web base First configuration Production view gi Production view Files Production view Scenes Pi Production view Missing links File view File view Local lini File view Rename file File view Move file File view Basic tat a File view Elements tab File view References tab File view Dependancy viewer tab SVN bindings aitei 2 29 Blender aid user manual Introduction Blender is a 3d content creation suite It enables user to model animate shade and do post productions composing on 3d content With Blender it is possible to create 3d games 2 5d animations and 3d animations What is Blender aid Blender aid is a tool that helps you manage Blender productions Blender focuses on the creation of content Blender aid focuses on managing the content of a production Big Buck Bunny consists of a lot of 3d content This content is located in many files Using Blender to manage content across files is difficult especially when the
6. aid shows different aspects of the technical data of your production Details are described below View render settings of all production files View all production files used by a production file View all production files that uses a production file View all direct neighbours users and used production files View missing links in a production View list of elements from a blend file View filtered references and dependencies table and graphic Refactoring Refactoring is the ability to change the structure of a production Rename production file Rename element of blend file Move production file 4 29 Blender aid user manual Installation 1 Download blender aid package what can be found at http code google com p blender aid downloads 2 Unzip the downloaded file into a directory 3 Optional Configure the settings see configuration This is only necessary when 1 using windows or 2 if one would like to use different settings 4 Run the application in command line by typing python server pyc or server pyc Make sure the user has read amp write privileges to the database location default var tmp The default location for windows is the installation directory Configuration of settings Currently only the web server listening port and the database location can be configured The web server listens default to port 8080 on localhost The default database location is var tmp sql bin Windows users should change the
7. asic SVN functionalities Select your production Add new production name Yo Frankie location var productions yf svn url http atmind svn yofrankie username test passwords m Add Blender aid will update the svn working folder during all refactoring actions During renaming of a file svn rename will be executed to update the bindings Blender aid can display the state of the working folder Blender aid can do basic SVN tasks like adding or reverting files When adding the production the Blender aid and the location does not exist the production will be checked out from the SVN repository For large productions this can take a while During this time the mouse will be turned in a waiting cursor hourglass or waiting wheel pending on your computer After selecting the production with SVN bindings a new menu item will be displayed SVN state This is highlighted in the next screenshot lt lt productions Yo Frankie LETS T Scenes Missing links SVN state var preductions yt filter 28 29 Blender aid user manual lt lt productions Yo Frankie T Scenes A Missing links SVN state Ivar productions yf filter C Normal Added amp Modified amp Deleted SUnversioned Missing 7 Ignore revision committer state location frankie actions blend modified jbakker 582 Revert added modified Jbakker 582 Revert modified jbakker 582 Revert deleted j
8. bakker 582 Revert franci_test em 13 items levels 19 item s found ipdate production Revert all Commit After usage the SVN state menu will display the SVN status of the working folder Using the filter a file can be searched Using the check boxes the different states can be filtered Update production will perform a SVN update Revert all will revert all files Commit will commit the changes to the SVN repository 29 29
9. content is not part of a single scene technical representation of a movie script What can you do with it The 2 main features of blender aid are visibility and refactoring Visibility presents technical data of a production in different ways like the links between files or the output settings of files Presenting the data in a useful way lets you see where and why a file is used With this information it is possible to answer questions like What scenes needs to be re rendered when you modify a file or a part of a file During the creation of a production changes happen Blender aid can perform complex refactoring tasks like renaming a file or moving a file to another folder location Blender aid will assure that the structure of the production stays intact How does it work Using Blender aid is very simple Just configure where your production is located on your computer Blender aid will inspect the files in the given location With your web browser you can navigate through your production and perform refactoring tasks When do you use it Blender aid has been designed for small teams working on blender animations or series But feel free to use it and see what it can do for you By using modern web and data warehousing techniques it enables you to quickly inspect and control your production 3 29 Blender aid user manual Features This section explains the main functional features of the tool Vis lity Blender
10. el 22 items ighthouse textures level_nut 11 sms 270 item s found The filter can be used to search for a specific files When clicking on a folder the files inside the folder will be displayed When clicking on the column headers the files will be sorted The folder structure will not be sorted 11 29 Blender aid user manual Production view Scenes The scenes tab has a advanced filter You can match every files to criteria In the section Columns you ll be able to view additional information of the scene lt lt productions Yo Frankie TScen s Missing links filter filename and scene name Sitind scenes which ures v 600x600 v as resolution find scenes with output not using 25 size reduction Ofind scenes what saves v to Ba v Oifind al scenes using less than 100 threadsfxy parts Snot saved in blender version 245 display only active scenes Columns basic file and scene information filename scene name blender information blender version pointersizs endianness compression scene output information resolution size output type scene frame information frame step start frame end frame Cscene optimalization information rt xparts yparts result blendfile scene resolution size output chars bird blend sUScene 1920x1920 50 PNG E charsibutterfiy blend SCScene 800x600 100 TGA fd charsibutterfiy blend SCtest group 800x600 100 TGA char
11. els level_underworld blend Change element reference GRFlyingSquirrel to GRFrankie Created levels level_lighthouse blend Change element reference GRFlyingSquirrel to GRFrankie Created chars trankie_testlevel blend Change element reference GRFlyinaSquirrel to GRFrenkia Created chars frankie blend Rename element GRFlyingSquirrel to GRFrankie Created 15 tems found Cannel Contin 22 29 Blender aid user manual File view References tab The reference tab shows all links to other files and all links that other files have to the current selected file Basic GElements References Dep Show graphical view References file type name textures generic_redrock_norjpg IM IMgeneric_redrock_nor p textures stone_cliff_tile_001_col ipg IM IMstone_cliff _tile_001_ 2 item s found displaying items 1 to 2 File is used by file type name levels level_underworld blend GR GRcave_entrance 1 item s found displaying items 1 to 1 It also has the ability to show a graphical display of the file in with their direct neighbour files The buttons on the top left enable you to move and to zoom the graphical display TODO how to read the graphical display 23 29 Blender aid user manual File view Dependancy The dependancy viewer tab is an advanced version of the references tab It has filter options of certain blender elements show only groups or groups and materials and it has t
12. ending on the speed of your computer Blender aid inspects all production files and will store this information in a database This process is 8 29 Blender aid user manual called indexing Indexing normally takes up to a few seconds but when a lot of changes happen it can take longer When indexing is done the screen will look like this lt lt productions Yo Frankie Y Scenes A Missing links Jvat productions yt filter location Litem chars 15 tems chars textures 20 tems dist e effects 7 tems franci_test 7 ems estamp franci_test textures hug 5 items levels 1 ems menus tems props 22 tems textures 13 items textures credits tems IB textures level_lighthouse 2 ems textures level_nut 1 items 270 item s found Now you are ready to use the tool 9 29 Blender aid user manual Production view The production view is the screen as displayed above It contains information of the selected production The view contains 3 choices in the header Files displays a list of production files It has a filter for quick finding of a specific production file Scenes display a list of all scenes in the production It can be used to find and align render settings Missing links display a list of all missing links between files SVN state is only visible when svn bindings are present It displays the state of SVN and has basic functio
13. evel_ratpack blend Change library reference frankie blend to fcankie_momo blend Craated Jevels minilevel_demo_arena3 blend Change library reference frankie blend to frankie_momo blend Created levels minilevel lava Falls blend Change library reference frankie blend to frankie mamo blend Created levels level_selector blend Change library reference frankie blend to feankie_momo blend Created levels lavel_selectar_other blend ange library reference frankie blend to frankie momo blend Createa levels level_underworld blend Change library reference frankie blend to frankie momo blend Created levels level lighthouse blend Change library reference trankie blend to feankie_mamo blend Created levels start_menu blend Change library reference frankie blend to frankie momo blend Created chars momo_actions blend Change library reference frankie blend to feankie_mamo blend Created chars frankie_actions blend Change library reference frankie blend to frankie momo blend Created chars feankie_testlevel blend Change library reference frankie blend to feankie_momo blend Created charsifrankio Rename frankio blendl to frankie_momo blend Created 15 emis found Cancel Continue Press continue to perform these tasks or press cancel to return to the file view After continue the tasks will be performed and you will be asked to rollback or commit the changes Before you continue
14. he ability to look broader than only direct linked files It also has a function to view all references in the total production wer tab Basic settings neighbour CAN 5 Bopject material FMesh ETexture Lamp Armature Action O Particle Scroup O camera 0 worid O Bitmage Elements SReferences 2dependancy viewer graphical display T Show detailed file reference information Show graph result result file evelsjievel_nut blend i Levels leval nut bleng levels level_nut blend levels levol_nut blend f levels level_nut blend levels level_nut blend f levels level_nut blend franci_test cerf volant blend references chars frankie blend GR chars frankie blend GR chars frankie blend GR chars frankie blend MA chars frankis biend MA f chare frankie blend MA f chars frankie blend MA ql chars frankieblend MA levels minilevel release Demo blend f chars frankie blend GR fi levels minilevel release Demo blend chars frankie blend GR evels minilevel release Demo blend fA chars frankie blend MA Gi Levela minilevel_ release Demo blend chars frankie plend MA levels minilevel_ release Demo blend chars frankie blend MA levels minilevel release Demo blend charsifrankie biend MA f loualefminilaval ralaace Domn hlond fA chare frantia hand amp MA type element GRFlyingSquirrel GRFlyingSquirrel GRMomoMonkey Matra
15. iguration When the server is started You can start a browser and browse to http localhost 8080 This can be different when configured otherwise When first started the next screen will be displayed filter Files location tems found displaying tems 1 ta 0 The first thing what has to be done is to add some productions to the tool Press lt lt productions in the upper right to open the production selection popup Select your production Add new production name location svn url username password Add First we need to add out production location to the tool For the next example I ve downloaded Yo Frankie And unzipped it to var productions yf Enter the next values 7 29 Blender aid user manual Select your production Add new production name Yo Frankie location var productions yF svn url username password Add After clicking on the link Add The production location is defined Select your production Yo Frankie Add new production name location svn url username password Add What has happened The location of the production Yo Frankie on the location var productions yf is not known by Blender aid Blender aid will extract the technical data from this location and be able to display it to you Now click on your newly added production Yo Frankie and the popup will close We have to wait for halve a minute or so dep
16. les It shows blender elements inside the file Yo Frankie Wwar productions yf chars frankie blend Move file Rename fi Open OBasic Elements ERefe filter Elements type name actions sc SCfrank_logic Rename MA Ma amp Aflyingsquirreleye Rename MA MaAfrankie_skin Rename MA MaAfrankie_theeth Rename MA MAfranky_ physics mat Rename MA MAmomo_skin_body Rename MA MAmomo_skin_eyelid Rename MA MAmomo skin_eyes Rename O8 OG OOOSSSSOSHOOE z gt MAtail_alpha Rename MA MAtail_col Rename OB OBL Rename OB OB2 Rename OB OBCamera_Ray Rename OB OBCamera_Scaler Rename OB OBDebugState Rename OB OBFrankie Rename OB OBFrankielnputJoy Rename OB OBFrankielnputKB Rename OB OBfx blast Rename OB OBLamp 002 Rename 63 item s found displaying items 1 to 20 1234 21 29 Blender aid user manual It has a filter to quickly find a specific element in the file And the possibility to rename an element When rename is clicked a popup will appear asking for a new name Basic GElements References Dependancy atta Elements type name actions GR GRFrankyNoLogic Rename GR GRMomoMonkey Rename mAn GR GRMomoNoLogic Rename Ocancei 4 N 4 item s found displaying items 1 to 4 The page at http oean new name for GRFlyingSquirrel GRFrankie Enter new location and press OK A screen will be displayed showing you what will be done Press continue t
17. mblebee blend Exit _Jtextures prop beehive nor png propsbee hive blend Fixit 3 textures vory pag Dpropsleatapults blend Et CyPragram Files Blender Foundation id downloads yofrankie bgeyblender game engine tectures Untitie tga levels level underworld blend Fix it 12 eos ou epyng tems 1 1 12 When clicking on Fix it a popup will appear with possible links what can be made These options are sorted by relevance Select the link file textures prop_bridge_col png chars textures char_bird_col png chars textures frankie tail2 png chars textures radialblend_01 png disi yofrankie png effects lightball png effeots shadow png franci_test textures hombo png franci test textures yo frankie a png hud franky health png 207 item s found displaying items 1 to 10 The relevance is determined by the name of the file missing texture link or by the usage of the file missing blend link After selecting an option the next screen will appear to fix the link 13 29 Blender aid user manual Tasks file description amp franci test cerf volant blend Change library reference to textures prop bridge col png Created state 1 item s found Cancel Continue Press continue to perform these tasks or press cancel to return to the production view After continue the tasks will be performed and you will be asked to rollback or commit the changes Before you continue please test the result After a commit or rollback you
18. nalities to revert and commit the changes to SVN When pressing on a link in a tab you will be show detailed information of the file This will be described in the File view section Production view Files The files tab displays files from the selected production 10 29 Blender aid user manual filter ll location size timestamp Litem chars 15 items bird blend 210672 Wed 06 Oct 2010 09 54 06 PM CET birdtest blend 210672 Wed 06 Oct 2010 09 51 49 PM CET blah blend 210672 Wed 06 Oct 2010 09 45 04 PM CET butterfiy blend 202789 Tue 05 Oct 2010 07 44 38 PM CET frankie blend 412706 Wed 06 Oct 2010 09 42 17 PM CET frankie_actions blend 1665074 Wed 06 Oct 2010 09 42 17 PM CET frankie momo blend 413697 Tue 05 Oct 2010 07 50 07 PM CET frankie testlevel blend 74397 Wed 06 Oct 2010 09 42 17 PM CET justablend blend 210672 Wed 06 Oct 2010 09 46 45 PM CET momo actions blend 1050122 Wed 06 Oct 2010 09 42 17 PM CET owl blend 210672 Wed 06 Oct 2010 09 41 15 PM CET rat_actions blend 302653 Tue 05 Oct 2010 07 44 38 PM CET sheep blend 391720 Tue 05 Oct 2010 07 44 38 PM CET sheep actions blend 642682 Tue 05 Oct 2010 07 44 38 PM CET test blend 210672 Wed 06 Oct 2010 09 43 19 PM CET chars textures 7 tems dist 1 tem effects 7 ems franci_test franci_test textures huq 5 tems 15 items 2 items levels menus 2 ems props 23 ms textures 150 ems textures credits 14 tems textures lev
19. nkie_skin Matail_col MAtail_alpha MAfyingsquirrel_ey MAfrankie_theeth GRFlyingSquicrel GRMomoMonkey Matranky_physics_mat MAamomo_skin_body MaAmomo_skin_eylid MAmomo_skin_eyos Matrantia evin the dropdown list has 4 options neighbour uses used production 24 29 Blender aid user manual Neighbour Shows only direct relations to and from the selected file example texture character scene when character is selected Uses Will show all relations and files the selected file depends on example texture character when character is selected Used Will show all relations and files what depends on the selected file example character scene when character is selected Production Show all relations between all files from the production Neighbours of sets intro blend All uses of sets intro blend 25 29 Blender aid user manual All used of sets intro blend View complete production Beneath the dropdown list it is possible to filter the relations not show unselected relations 26 29 Blender aid user manual OAI O Object Material O Y Mesh O Bi Texture O 8 Lamp o armature o Action O Particle SGroup O camera O world 0 Bimage When All is selected the other selections are not shown 27 29 Blender aid user manual SVN bindings When the production has been checked out with SVN information blender aid provides b
20. o perform these tasks or press cancel to return to the file view After continue the tasks will be performed and you will be asked to rollback or commit the changes Before you continue please test the result of the rename After a commit or rollback you will be show the production view Re factoring Tasks Tle description state franci _test c rf_volant blend Change el ment reference GRFlyingSquirrel to GRFrankis Created levelsflevel_nut blend Change element reference GRFlyinaSquirrel to GRFrankie Created levels minilevel release Demo blend Change element reference GRFlyingSquirrel to GRFrankis Created levelsfevel_1_home blend Change element references GRFlyingSquirrel to GRFrankie Created levelsfibrary blend Change element reference GRFlyingSquirrel to GRFrankiel Created levels minilevel_the Arena blend Change element reference GRElyingSquirrel to GRFrankis Created levels minilevel ratpack blend Change element reference GRFlyingSquirral to GRFrankis Created levels minilevel_demo_arena3 blend Change element reference GRFlyingSquirrel to GRFrankis Created levels minilevel_lava_Falls blend Change element reference GRFlyingSquirrel to GRFrankie Created levelslevel_selector blend Change element reference GRFlyinaSquirrel to GRFrenkie Created levels evel_selector_other blend Change element reference GRFlyingSquirrel to GRFrankie Created lev
21. s frankie blend SCirank logic 640x450 75 PNG chare frankie_actions blend SCfrank_logic 640x640 75 PNG A chars frankie_testlevel blend sCScene 800x600 100 JPEG chars momo_actions plend SUScene BO0x600 100 JPEG chars rat actions bhlend SCScene 800x600 100 JPEG f chars shsep blend SCsheeplogic 1920x1080 25 PNG Gi charelchoen artinne Kland Srehaan lanmin DE PN 12 29 Blender aid user manual Production view Missing links When viewing the missing links you ll be shown a table with all missing links in the production At the moment these links are only missing file links In the future this can be enhanced with missing elements The following files are referenced but not found Missing links missing file used by actions dranc tosttextures prop_bridge_col png Franci testicerf volant blend Fixit textures level lighthousejyo frankie a png franci testjcer volant blend Fhe it toxtures iovellighthouse bombo png Tanel testbumblebee blend Fut cAProgram Files Blender Foundation Blender2 48 blender yafrankie bf asselsiextures bombo png franci test bumblebee blend Fixit Jcharsfextures Myingsgulrrel skin col png ancl testoumbleboe bland Fult Jcharsftextures flyingsquirrel skin nor png franci test bumblebes blend Fir it 3 _jcharsitexturos tiyingsqulrrel skin spec png Tanc test bumbleboe blend ELLE charsjtextures frankie tail2 png franci testibumblebee blend Fixit i eharstexturesfradialblend 01 png Tanc testbu
Download Pdf Manuals
Related Search