Difference between revisions of "Blender"

From UFRC
Jump to navigation Jump to search
 
(15 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{|align=right
+
[[Category:Software]][[Category:GUI]][[Category:Graphics]]
  |__TOC__
+
{|<!--CONFIGURATION: REQUIRED-->
  |}
+
|{{#vardefine:app|Blender}}
[[Image:tux.jpg|right|Rendered version of Tux]]
+
|{{#vardefine:url|http://www.blender.org/}}
==Description==
+
<!--CONFIGURATION: OPTIONAL (1=ON)-->
Blender is an integrated suite of tools enabling the creation of a broad range of 3D content with the singular benefits of cross-platform interoperability and an incredibly small download file size. It is the most popular Open Source 3D graphics application in the world, and is one of the most downloaded.
+
|{{#vardefine:exe|1}} <!--RUNNING -->
==Website==
+
|{{#vardefine:conf|}} <!--CONFIGS-->
* Main website: [http://www.blender.org www.blender.org]
+
|{{#vardefine:pbs|}} <!--PBS SCRIPTS-->
* Documentation website: [http://wiki.blender.org/index.php/Manual Wiki.blender.org]
+
|{{#vardefine:policy|}} <!--POLICY-->
 +
|{{#vardefine:testing|}} <!--TESTING/PROFILING-->
 +
|{{#vardefine:faq|}} <!--FAQ-->
 +
|{{#vardefine:citation|}} <!--CITATION-->
 +
|{{#vardefine:installation|}} <!--INSTALLATION-->
 +
|{{#vardefine:tutorial|1}} <!--TUTORIAL-->
 +
|}
 +
<!--BODY-->
 +
<!--Description-->
 +
{{#if: {{#var: url}}|
 +
{{App_Description|app={{#var:app}}|url={{#var:url}}|name={{#var:app}}}}|}}
  
==Location==
+
3D graphics rendering
/apps/blender/2.45
 
  
==Usage==
+
<!--Modules-->
Remember, the HPC computational resources are not to be used for developing the blend file! The idea is that you get the blend file ready to go, then transfer that blend file to the HPC Center and submit a job to do the rendering. This is where a good portion of the time takes place.
+
==Environment Modules==
 
+
Run <code>module spider {{#var:app}}</code> to find out what environment modules are available for this application.
==Command Line Arguments==
+
==System Variables==
<pre>
+
* HPC_{{uc:{{#var:app}}}}_DIR - installation directory
Blender 2.44 (sub 0) Build
+
<!--Additional-->
Usage: blender [options ...] [file]
+
{{#if: {{#var: exe}}|==Additional Information==
 
+
* Note: The server hardware that this will run on does not have any audio hardware built in, nor would it be audible since the hardware is installed in a separate room. As such, the blender command has been aliased so that the "'''-noaudio'''" flag is automatic.
Render options:
+
|}}
  -b <file>    Render <file> in background
+
<!--Configuration-->
    -S <name>  Set scene <name>
+
{{#if: {{#var: conf}}|==Configuration==
    -f <frame>  Render frame <frame> and save it
+
See the [[{{PAGENAME}}_Configuration]] page for {{#var: app}} configuration details.
    -s <frame>  Set start to frame <frame> (use with -a)
+
|}}
    -e <frame>  Set end to frame (use with -a)<frame>
+
<!--PBS scripts-->
    -o <path>   Set the render path and file name.
+
{{#if: {{#var: pbs}}|==PBS Script Examples==
      Use // at the start of the path to
+
See the [[{{PAGENAME}}_PBS]] page for {{#var: app}} PBS script examples.|}}
        render relative to the blend file.
+
<!--Policy-->
      Use # in the filename to be replaced with the frame number
+
{{#if: {{#var: policy}}|==Usage Policy==
      eg: blender -b foobar.blend -o //render_# -F PNG -x 1
+
WRITE USAGE POLICY HERE (perhaps templates for a couple of main licensing schemes can be used)
    -F <format> Set the render format, Valid options are..
+
|}}
        TGA IRIS HAMX FTYPE JPEG MOVIE IRIZ RAWTGA
+
<!--Performance-->
        AVIRAW AVIJPEG PNG BMP FRAMESERVER
+
{{#if: {{#var: testing}}|==Performance==
    (formats that can be compiled into blender, not available on all systems)
+
DOUBLE_CLICK_TO_WRITE_PERFORMANCE_TESTING_RESULTS_HERE
        HDR TIFF EXR MPEG AVICODEC QUICKTIME CINEON DPX
+
|}}
    -x <bool>  Set option to add the file extension to the end of the file.
+
<!--Faq-->
    -t <threads>        Use amount of <threads> for rendering
+
{{#if: {{#var: faq}}|==FAQ==
 
+
*'''Q:''' **'''A:'''|}}
Animation options:
+
<!--Citation-->
  -a <file(s)>  Playback <file(s)>
+
{{#if: {{#var: citation}}|==Citation==
    -p <sx> <sy>        Open with lower left corner at <sx>, <sy>
+
If you publish research that uses {{#var:app}} you have to cite it as follows:
    -m          Read from disk (Don't buffer)
+
DOUBLE_CLICK_TO_WRITE_CITATION_HERE
 
+
|}}
Window options:
+
<!--Installation-->
  -w            Force opening with borders (default)
+
{{#if: {{#var: installation}}|==Installation==
  -W            Force opening without borders
+
See the [[{{PAGENAME}}_Install]] page for {{#var: app}} installation notes.|}}
  -p <sx> <sy> <w> <h>  Open with lower left corner at <sx>, <sy>
+
<!--Tutorial-->
                        and width and height <w>, <h>
+
{{#if: {{#var: tutorial}}|==Tutorial==
 
+
* There are a number of different tutorials on the [http://www.blender.org/support/tutorials/ Blender Tutorial] webpage.
Game Engine specific options:
+
|}}
  -g fixedtime          Run on 50 hertz without dropping frames
+
__NOTOC____NOEDITSECTION__
  -g vertexarrays      Use Vertex Arrays for rendering (usually faster)
 
  -g noaudio            No audio in Game Engine
 
  -g nomipmap          No Texture Mipmapping
 
  -g linearmipmap      Linear Texture Mipmapping instead of Nearest (default)
 
 
 
Misc options:
 
  -d            Turn debugging on
 
  -noaudio      Disable audio on systems that support audio
 
  -h            Print this help text
 
  -y            Disable script links, use -Y to find out why its -y
 
  -P <filename> Run the given Python script (filename or Blender Text)
 
  -v            Print Blender version and exit
 
</pre>
 
As a note, all attempts so far to get the -o OUTPUTFILE option to work have been unsuccessful. Please be sure to define the output file location in the blend file itself.
 
 
 
==Sample Script==
 
 
 
The sample PBS script can now be found on the [[PBS Sample Job Scripts#Blender|PBS Sample Job Scripts]] page.
 
 
 
Note that you should add your address to the appropriate line in this case. Also note that the walltime has been set to 2 hours. You will have to figure out through trial and error what the most appropriate amount of time for a rendering should be. In this particular example:
 
* Blender will render the first frame of either a static or dynamic animation.
 
* It will use two threads to perform this operation, hence defining that PBS should use two processors on a single node.
 
** With preliminary testing, this also does not appear to be working properly. There is a setting within the rendering options in Blender itself that you can set the number of threads to work from. I recommend setting this to four, and defining the ppn above to four as well.
 
* The output of the frame will be wherever it was defined in the blend file that was originally saved.
 
 
 
Setting the proper path for the output in the blend file is '''critical''', as this is a batch based system and you will have no idea which computational node actually does the processing. Be sure to set the output path to a known location in the global filesystem, either /scratch/ufhpc or /home/<username>. The default in linux is to set this to /tmp, which will simply dump the output to that directory on the local computational node, which means you will not get the results.
 
==Build==
 
Support programs needed by Blender for compilation:
 
* [[Freealut]]
 
* [[OpenEXR]]
 
* [[MesaLib]]
 
===Configuration Files===
 
''/apps/blender/blender-<ver>/source/nan-definitions.mk'':
 
<pre>
 
    export NAN_PYTHON ?= /apps/blender
 
    export NAN_OPENAL ?= /apps/blender
 
    export NAN_JPEG ?= /apps/blender
 
    export NAN_PNG ?= /apps/blender
 
    export NAN_FREETYPE ?= /apps/blender
 
    export NAN_SDL ?= $(shell /apps/blender/bin/sdl-config --prefix)
 
    export NAN_SDLLIBS ?= $(shell /apps/blender/bin/sdl-config --libs)
 
    export NAN_SDLCFLAGS ?= $(shell /apps/blender/bin/sdl-config --cflags)
 
</pre>
 
''/apps/blender/blender-<ver>/source/nan_link.mk'':
 
<pre>
 
    LLIBS = -L$(NAN_MESA)/lib -L/usr/X11R6/lib64 -lXmu -lXext -lX11 -lXi
 
    LLIBS += -L/usr/lib64
 
</pre>
 
 
 
===Environment Variables===
 
<pre>
 
PKG_CONFIG_PATH="/apps/blender/lib/pkgconfig/"
 
INCLUDE="/apps/blender/include:/apps/blender/include/OpenEXR"
 
</pre>
 

Latest revision as of 15:43, 10 June 2022

Description

Blender website  

3D graphics rendering

Environment Modules

Run module spider Blender to find out what environment modules are available for this application.

System Variables

  • HPC_BLENDER_DIR - installation directory

Additional Information

  • Note: The server hardware that this will run on does not have any audio hardware built in, nor would it be audible since the hardware is installed in a separate room. As such, the blender command has been aliased so that the "-noaudio" flag is automatic.




Tutorial