< Previous | Contents | Manuals Home | Boris FX | Next >
Blender Settings
Here's some information about the blender export control panel settings. Note that each control on the blender export control has explanatory tooltips if you hover over it.
Blender version. Dropdown. Select the version you are using, or the most recent version before it. If you don't set this correctly, blender will report errors when you try to run the exported script.
Hex mesh workaround. Checkbox. Blender 3.2 includes a buggy Python implementation that causes blender to crash when large meshes are exported. With this checkbox on, meshes will be exported in a different way than normal, producing much bigger and slower-to-read files—though they are much faster for blender to read. Accordingly, this option may be useful in general.
Script type. Radio. Normally, the export will create a whole new Blender scene with all the SynthEyes elements. If you have previously done that, then modified the blender scene, and then changed the tracking, you can use the Update existing scene to bring the modified tracking data into Blender, so you don't have to manually merge the scenes. Note that Update mode concentrates on information affected by solves: position information for the camera and trackers—it doesn't update mesh structures or textures that you may have changed in blender.
Create armatures. Checkbox. When checked, GeoH animation will produce an animated blender armature and bones. When not checked, they will result in an animated vertex cache. The armature is better when you want to edit the animation itself in blender. The vertex cache is good when you want to lock in the exact results from SynthEyes.
Update mesh caches. Checkbox. Applies only when Create armatures is off, and you are using “Update existing scene.” This checkbox controls whether or not vertex caches are regenerated each time you update. When this checkbox is ON, deformed caches will have a new vertex cache written for each update. When it is OFF, no updated cache is written (to save time), and the old animation will persist. The mesh must not have been edited, and any anamorphic distance must not have changed!
Use quads. Checkbox. When checked, meshes are output as quads when possible. If off, triangles are used.
Fix Anam. distance. Checkbox. When on and an anamorphic distance is present, each mesh is exported with a vertex cache, and tracker positions are compensated, so that the shot lines up (as seen only from *this* current active camera) in non- saavy downstream applications. Won't fix meshes with rigs or pre-existing vertex caches.
Rescale scene. Number. You can rescale the entire scene by this factor. Usually the scene scaling should be done as part of the coordinate system setup; the rescale
value is useful only when you are exporting the same scene to several downstream applications that have different requirements.
Tracker size. Number. Size of the axis nulls for trackers.
Use Camera Background. Checkbox. When set, SynthEyes will use Blender 2.80's camera background for the shot images. Otherwise, a textured mesh projection screen will be produced. Note that a projection screen will always be used if lens distortion is present (always run Lens Workflow!).
UV screen mode. Drop-down. Controls when the alternate form of projection screen is use. The normal screen re-positions vertices based on distortion, with a fixed set of texture coordinates. The alternate form uses a fixed set of vertex coordinates, creating a modified set of texture coordinates. The normal version is fine for computed distortions in general. The alternate form is necessary for 1-pass lens workflow setups when the distortion is expressed as a UVMap (STMap), and may also be necessary for some 2-pass setups. The alternate form cannot be used for animated distortions. The settings for this control are Never, If a UVmap is present, and Always. The “If a UVmap is present” setting is the default and is generally a reasonable approach, though you can use the other settings as the specific scene warrants.
Horizontal Grids. Number. This is the number of horizontal grids in any projection screen that the exporter produces. The vertical count is determined by dividing by the aspect ratio.
Screen RelDist. Number. Relative distance to the screen, as a multiple of the world size.
Clipping RelDist. Number. Far clipping plane distance, as a multiple of the world size.
Make shot start at. Number. Normally the first frame of the shot imager will start at frame zero in blender. This value allows you to override that.
Delete pre-existing meshes. When checked, the default blender Cube will be deleted.
Remove path prefix. Text string. This prefix is removed from filenames as they are exported, typically when the resulting python file will be run on a different machine. For example, you might remove a C: drive letter or /Volumes.
Add path prefix. Text string. This gets added to filenames, for example so that you can
add a C: or /Volumes/ to the beginning of the filenames.
Open in Blender automatically. Checkbox. Check this to have blender start and run the exported python file quickly and automatically. Not applicable when updating an existing scene (it will be ignored).
Blender application. This tells SynthEyes where to find the desired version of Blender.
Extra arguments. These command-line arguments are given to blender during auto- run; for example you can control where it starts up, or pass SynthEyes SyPy3 port/pin information.
©2024 Boris FX, Inc. — UNOFFICIAL — Converted from original PDF.