blast

guerilla.blast(width, height, file, camera, firstframe, lastframe, framestep, framerate, quality, fovmode, showgrid, sampling, separateStereo, filterPrimitives, filterCameras, filterLights, showfilename, showframenumber, keepImages, shadingMode, codec, forceFilename)

Render an blast sequence

This function renders a sequence of images from a given camera, using the OpenGL viewport.

All parameters are optionnal, and will be guessed when missing. The camera can either be a Camera object, either a string giving the name or the path of the camera, or nil to use the Main Camera (or the Perspective if no Main Camera.) Width defaults to the project’s width setting, and height is computed from frame width and camera ratio. First frame and last frame are guessed from the current time line, framestep defaults to 1. FrameRate defaults to 25, quality to 80. Fovmode is “fullframe”, and showgrid is false. When file is missing, Guerilla opens a file selector, unless Guerilla is started with –nogui. The arguments can be passed to the command through an array like this : LUA{blast { width = 640, height = 480, file = “F:/Code/blast/test.mov”, shadingMode = “shaded” }}

param width:The image width (default is project default width) type width:int param height:The image height (default is project default width divided by camera frame ratio) type height:int param file:The saved image file name. To get an image sequence, use the “.png” extension, for a movie, use the “.mov” one. The movie ceation is not available under GNU/Linux. type file:str param camera:The camera to use for blast rendering (default is Main Camera, or Perspective if no Main Camera) type camera:Camera or str param firstframe:  The first frame of the range to be rendered (default is time line first frame) type firstframe:  int param lastframe:  The last frame of the range to be rendered (default is time line last frame) type lastframe:int param framestep:  The step between 2 frames being rendered (default is 1) type framestep:int param framerate:  The encoded QuickTime movie frame rate, in fps (default is 25 fps) type framerate:int param quality:The encoded QuickTime movie quality, from 0 to 100 (default is 80) type quality:int param fovmode:The Field Of View gatting mode (may be “gatedframe”, “gatedwidth”, “gatedheight”, “fullframe” (default), “fullwidth”, “fullheight”) type fovmode:str param showgrid:Is the world grid displayed or not when rendering blast (default is false) type showgrid:bool param sampling:The number of samples for antialiasing (default is 1) type sampling:int param separateStereo:  If true, render separate stereo images/movies (default is false) type separateStereo:  bool param filterPrimitives:  Display the primitives or not (default is true) type filterPrimitives:  bool param filterCameras:  Display the cameras gizmo or not (default is true) type filterCameras:  bool param filterLights:  Display the lights gizmo or not (default is true) type filterLights:  bool param showfilename:  Display the file name (default is false) type showfilename:  bool param showframenumber:  Display the frame number (default is false) type showframenumber:  bool param keepImages:  In movie mode, keep the images if true. (default is false) type keepImages:  bool param shadingMode:  The shading mode (“wireframe”, “filled”). If nil, use the camera mode. type shadingMode:  str param codec:The codec to use (“h261”, “h263”, “h264”, “jpeg2000”, “motionjpega”, “motionjpegb”, “mpeg”, “mpeg4”, “sorensen”, “sorensen3”, “animation”, “png”, “tiff”) (default is “h264”) type codec:str param forceFilename:  If true, original image file name is kept (default is false) type forceFilename:  bool