Difference between revisions of "Blender"

From UFRC
Jump to navigation Jump to search
 
(13 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{|align=right
+
[[Category:Software]][[Category:Graphics]]
  |__TOC__
+
{|<!--CONFIGURATION: REQUIRED-->
  |}
+
|{{#vardefine:app|Blender}}
==Description==
+
|{{#vardefine:url|http://www.blender.org/}}
[http://www.blender.org www.blender.org|blender website]
+
<!--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 -->
==Usage==
+
|{{#vardefine:conf|}} <!--CONFIGS-->
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.
+
|{{#vardefine:pbs|}} <!--PBS SCRIPTS-->
==Command Line Arguments==
+
|{{#vardefine:policy|}} <!--POLICY-->
<pre>
+
|{{#vardefine:testing|}} <!--TESTING/PROFILING-->
Blender 2.44 (sub 0) Build
+
|{{#vardefine:faq|}} <!--FAQ-->
Usage: blender [options ...] [file]
+
|{{#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}}}}|}}
  
Render options:
+
3D graphics rendering
  -b <file>    Render <file> in background
 
    -S <name>  Set scene <name>
 
    -f <frame>  Render frame <frame> and save it
 
    -s <frame>  Set start to frame <frame> (use with -a)
 
    -e <frame>  Set end to frame (use with -a)<frame>
 
    -o <path>  Set the render path and file name.
 
      Use // at the start of the path to
 
        render relative to the blend file.
 
      Use # in the filename to be replaced with the frame number
 
      eg: blender -b foobar.blend -o //render_# -F PNG -x 1
 
    -F <format> Set the render format, Valid options are..
 
        TGA IRIS HAMX FTYPE JPEG MOVIE IRIZ RAWTGA
 
        AVIRAW AVIJPEG PNG BMP FRAMESERVER
 
    (formats that can be compiled into blender, not available on all systems)
 
        HDR TIFF EXR MPEG AVICODEC QUICKTIME CINEON DPX
 
    -x <bool>  Set option to add the file extension to the end of the file.
 
    -t <threads>        Use amount of <threads> for rendering
 
  
Animation options:
+
<!--Modules-->
  -a <file(s)>  Playback <file(s)>
+
==Environment Modules==
    -p <sx> <sy>        Open with lower left corner at <sx>, <sy>
+
Run <code>module spider {{#var:app}}</code> to find out what environment modules are available for this application.
    -m          Read from disk (Don't buffer)
+
==System Variables==
 
+
* HPC_{{uc:{{#var:app}}}}_DIR - installation directory
Window options:
+
<!--Additional-->
  -w            Force opening with borders (default)
+
{{#if: {{#var: exe}}|==Additional Information==
  -W            Force opening without borders
+
* 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.
  -p <sx> <sy> <w> <h>  Open with lower left corner at <sx>, <sy>
+
|}}
                        and width and height <w>, <h>
+
<!--Configuration-->
 
+
{{#if: {{#var: conf}}|==Configuration==
Game Engine specific options:
+
See the [[{{PAGENAME}}_Configuration]] page for {{#var: app}} configuration details.
  -g fixedtime          Run on 50 hertz without dropping frames
+
|}}
  -g vertexarrays      Use Vertex Arrays for rendering (usually faster)
+
<!--PBS scripts-->
  -g noaudio            No audio in Game Engine
+
{{#if: {{#var: pbs}}|==PBS Script Examples==
  -g nomipmap          No Texture Mipmapping
+
See the [[{{PAGENAME}}_PBS]] page for {{#var: app}} PBS script examples.|}}
  -g linearmipmap      Linear Texture Mipmapping instead of Nearest (default)
+
<!--Policy-->
 
+
{{#if: {{#var: policy}}|==Usage Policy==
Misc options:
+
WRITE USAGE POLICY HERE (perhaps templates for a couple of main licensing schemes can be used)
  -d            Turn debugging on
+
|}}
  -noaudio      Disable audio on systems that support audio
+
<!--Performance-->
  -h            Print this help text
+
{{#if: {{#var: testing}}|==Performance==
  -y            Disable script links, use -Y to find out why its -y
+
DOUBLE_CLICK_TO_WRITE_PERFORMANCE_TESTING_RESULTS_HERE
  -P <filename> Run the given Python script (filename or Blender Text)
+
|}}
  -v            Print Blender version and exit
+
<!--Faq-->
</pre>
+
{{#if: {{#var: faq}}|==FAQ==
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.
+
*'''Q:''' **'''A:'''|}}
 
+
<!--Citation-->
==Sample Script==
+
{{#if: {{#var: citation}}|==Citation==
 
+
If you publish research that uses {{#var:app}} you have to cite it as follows:
The sample PBS script can now be found on the [[PBS Sample Job Scripts#Blender|PBS Sample Job Scripts]] page.
+
DOUBLE_CLICK_TO_WRITE_CITATION_HERE
 
+
|}}
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:
+
<!--Installation-->
* Blender will render the first frame of either a static or dynamic animation.
+
{{#if: {{#var: installation}}|==Installation==
* It will use two threads to perform this operation, hence defining that PBS should use two processors on a single node.
+
See the [[{{PAGENAME}}_Install]] page for {{#var: app}} installation notes.|}}
** 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.
+
<!--Tutorial-->
* The output of the frame will be wherever it was defined in the blend file that was originally saved.
+
{{#if: {{#var: tutorial}}|==Tutorial==
 
+
* There are a number of different tutorials on the [http://www.blender.org/support/tutorials/ Blender Tutorial] webpage.
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, like /scratch/ufhpc. 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.
+
|}}
 
+
__NOTOC____NOEDITSECTION__
==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 13:03, 15 August 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