Wrap4D Change Log

Wrap4D 2023.11.14

Released November 2023

New Nodes

IconStickContour StickContour

adds a sticky-lips effect, closes lips and eyelids and minimizes manual cleanup.


Bug Fixes

  • In SelectPointsWithSplines node fixed a bug with incorrect cursor snapping on rotated geometry.

  • In SelectPointsWithSplines node fixed a bug after starting to draw a spline using the Alt + LMB shortcut.

  • In SelectPolygons node fixed a crash, when selection was loaded from file and input was disconnected.

  • In LoadScreenPoints node fixed double normalization bug.

  • In Brush node fixed a title mistake Hidden polygons to Visible polygons.

  • In VertexMask node fixed a bug, when clicking Inverse button leads to resetting the mask if no geometry was connected.

  • In Node-Graph Editor fixed a bug, when selecting half of selected nodes didn’t alter a selection.

  • In the gallery fixed UV of WrapHead2 OBJ geometry.

Wrap4D 2023.10.9

Released October 2023


  • In WrapCMD restored running compute without args as computing frame 0. Interactive mode is now available with --interactive flag. Check Command Line Interface for details.

  • Finishing dialog after Nodes >> Compute All now is showing total computing time.

  • In LoadScreenPoints added explicit Frame parameter with a default script.

  • In MergePoints added a Visual Editor, Geometry input and Show Labels param.

Bug Fixes

  • In RemoveSpikes node removed geom connectivity requirement.

  • In PointDetector fixed OpenGL requirement. It’s now unnecessary for providing accepted result, only for computing.

  • In WrapCMD fixed error printing order.

  • In Nodes >> Compute All fixed progress bar freeze.

  • Fixed a crash when disconnecting multiple ouputs from multiple inputs in a specific order.

  • In Python code editor fixed highlighting with all unicode characters.

Wrap4D 2023.10.6

Released October 2023


  • In Node-Graph Editor you now can select multiple nodes and Node Editor, Visual Editor and rest will still be shown for one of them, the active one. You can change the active node by clicking on one of selected ones or throught a list in the top of Node Editor block.

  • In Viewport2D Color Picker improved. Now shown hex is compatible with other softwares color pickers, such as Photoshop.

  • In Python code editor improved syntax highlighting.

Bug Fixes

  • Fixed a crash in WrapCMD when computing LoadVertices node without OpenGL context.

  • Fixed slowdown in ImageFacialWrapping node computations in batch mode over time on Windows.

  • In Python parameters expressions converting from color hex now assumes sRGB input format to match other softwares. Also expected colors are now stated as unpremulted.

  • In Nodes >> Compute All dialog fixed an error when nodes with errors prevent progressbar from moving.

  • In VertexMask visual editor fixed a bug when clicking in any place in viewport forces recomputing node’s output.

  • In LoadVertices fixed error formatting when can’t open file. Filepath isn’t appearing twice now.

  • In MergeVertexMask and Blendshapes fixed error when adjusting sliders couldn’t be undone with CTRL + Z.

  • In Blendshapes fixed incorrect normals in Visual Editor.

  • In Nodes >> Compute All dialog fixed an error when you could accidentally press ESC and hide a progress dialog forever.

  • Fixed an error when pressing Ctrl while dragging a dock panel didn’t make panel floating.

Wrap4D 2023.10.1

Released October 2023


  • In FixSymmetry node added caching for finding symmetry.

  • In the WrapCMD added an environment variable WRAPCMD_NO_OPENGL to ignore OpenGL while computation.

Bug Fixes

  • In OpticalFlowWrapping fixed a crash when computing with empty point correspondences.

  • In SelectPointPairs fixed a crash when loading poits from file with missing input geometry.

  • In Node-Graph Editor fixed an error when releasing MMB or RMB during dragging a connection resulted in connecting to the closest plug.

Wrap4D 2023.09.9

Released September 2023

New Nodes

IconSelectPointsWithSplines SelectPointsWithSplines

lets you to draw precise splines on a model and sample them to named points


  • Added a SelectPointsWithSplines node and example gallery project.

  • In Nodes >> Compute All dialog added settings cache and range progress info, fixed post-compute summary.

  • In LoadVertexMask improved error handling.

  • The project is now marked as unsaved when timeline range is changed.

Bug Fixes

  • In Nodes >> Compute All fixed an error where selected frame ranges are cleared when focus is removed.

  • In several nodes fixed Null point correspondences error when missing optional input.

  • In Node-Graph Editor fixed a crash after multiply clicking on node’s plugs.

Wrap4D 2023.09.4

Released September 2023


  • Added TexturingXYZ project to the gallery.

  • Added Python project global script support.

  • Added expected type hints to Python parameters expressions and improved editor actions.

  • Added custom ranges support and Step Size param to Nodes >> Compute All.

  • Added several new shortcuts for the common menu tools.

  • In Command Line Interface added new options and mode helps.

  • In ImageFacialWrapping node added second facial detection support and additional caching, which speeds up computations after the first frame by 33%.

  • In FastWrapping node added Sampling Type param.

  • In LoadAlembic node added Frame and Frame Per Second params.

  • In SelectPolygons and ModifyVertexMask nodes added topological mirror and symmetrize tools.

  • In Node-Graph Editor added connection transparency and highlighting and removing elements with CTRL + LMB.

  • In MergeImage changed blend modes to work correctly with semitransparent images.

  • In MergeVertexMask added new modes and simplified formulas.

  • Added the ability to work with 32-bit images to node UndistortImage.

  • In saving nodes File Name defualt value changed to Frame######.ext for consistensy.

  • In image and camera nodes added Lock Aspect Ratio check to Resolution param and changed default resolutions to the common ones.

Bug Fixes

  • Fixed crashes with several cases using nodeParamValue.

  • Fixed an error when editing multiple params partially defined by a Python expressions led to a crash.

  • Fixed errors when adding, removing and copy-pasting nodes with multiple inputs.

  • Fixed missing and wrong nodes recomputes on changing global values.

  • Fixed an error when node depending on $PROJECT_NAME or projectName(), didn’t recompute after saving project with new name.

  • Fixed an error when Path Interpretation worked too greedy and matched $PROJECT_NAME in the file names.

  • Fixed a crash of Compute All during computation Render node in CPU mode.

  • Fixed an error when Render node in CPU mode interpolates the texture with half pixel offset.

  • Fixed an error when Render node’s visual editor backgrounds reset to default on every project saving and preferences editing.

  • Fixed an error when Blendshapes node’s result had incorrectly directed normals.

  • Fixed an error when Wrappings computation was available during incorrect Point correspondences input.

  • Fixed an error when saving project with Python scripts containing brackets inside the quoutes lead to appearance of extra spacebars.

  • Fixed an error when Viewport2D UV fits to view only first UDIM of multiple UDIMs geometry.

  • Fixed an error when LoadFrameFromVideo default Frame expression reappears on reloading or copying.

  • Fixed an error when in param with Python expression of type list of strings could read a string as a sequence.

Wrap4D 2023.06.7

Released June 2023

New Nodes

IconUndistortCamera UndistortCamera

undistorts a camera

IconUndistortImage UndistortImage

adapts an image to the camera’s undistorted view

IconUndistortScreenPoints UndistortScreenPoints

adjust screen points positions to match camera’s undistorted view

IconUndistortFacialDetection UndistortFacialDetection

adjust facial detection points to match camera’s undistorted view

IconImageFacialWrapping ImageFacialWrapping

wraps a geometry to match two image projections

IconGuidableTexture GuidableTexture

creates a texture for geometry using examples provided

IconGuidableReplace GuidableReplace

replaces a part of geometry using examples provided

IconGuidableMesh GuidableMesh

generates a new mesh using examples provided

IconGuidableHeadStabilization GuidableHeadStabilization

stabilizes a geometry based on stabilized blends examples

IconGuidableDeltaMush GuidableDeltaMush

performs a DeltaMush using examples provided

IconKeepDistance KeepDistance

maintains a given distance between two geometries given

IconCartoonWrapping CartoonWrapping

wrap cartoonish characters and creatures easily

IconOffsetSurface OffsetSurface

moves geometry’s vertices along it’s normals

IconStickToSurface StickToSurface

transfers topology between blendshapes sequences

IconFixIntersections FixIntersections

resolves geometry’s self-intersections or intersections with a collider

IconFillHoles FillHoles

fills holes in geometry with triangles

IconMergeGeom MergeGeom

merges multiple geometries into a signle one

IconDetectionToMask DetectionToMask

creates a white-black masking image using a facial detection

IconProjectTextureThroughCameras ProjectTextureThroughCameras

creates a texture, which is a sum of masked projections of several other textures

IconAlignGeomToCameras AlignGeomToCameras

rigidly aligns geometry to match several image projections

IconAngularImageBlur AngularImageBlur

blurs an image by rotating around the given origin

IconFitEyesDirection FitEyesDirection

calculates rotations for eyes geometries to match a given image

IconInterpolateMissedEyes InterpolateEyes

interpolates eye’s rotations within established detected values

IconBakeTransform BakeTransform

bakes geom’s transform into vertex positions

IconLoadFrameFromVideo LoadFrameFromVideo

loads a frame from a videofile as an image

IconLoadVertices LoadVertices

loads vertices from the PLY format to geometry

IconSaveVertices SaveVertices

saves geometry’s vertices to the PLY format

IconLoadCamera LoadCamera

loads a camera from variety of formats

IconSavePoints SavePoints

saves named points on triangles to file

IconSelectScreenPoints SelectScreenPoints

allows to select screen points on any given image

IconLoadVertexMask LoadVertexMask

loads a vertex mask from file

IconSaveVertexMask SaveVertexMask

saves a vertex mask to file

IconRigidHeadStabilization HeadStabilization

finds stabilization transform for input expression and a neutral geometry.

IconNeuralFacelRegression NeuralFaceRegression

allows to produce a 3D mesh by looking at a monocular image sequence of the actor’s performance

IconTemporalSmoothing TemporalSmoothing

node version of removed TemporalSmoothing tool

Major Features

Minor Features

Major Bugfixes

  • In LoadGeom has been fixed memory leak while loading a Draco.

  • In FacialDetection crash on multiple computes has been fixed.

  • While Compute Range memory block has been fixed. Previously, memory was freed only once you press OK in a dialog.

  • In Node-Graph Editor recursive connections crash has been fixed.

  • In many of Geometry nodes caching has been improved. Previously, changing Visual Param of input geometry such as color or wireframe visibility could break already cached nodes. It affects such node as RemoveSpikes, DeletePolygons, Blendshapes, etc.

  • In FastWrapping inconsistense Compute and Auto-Compute results has been fixed.

  • In FastWrapping freeze and crash on selected point on noisy detached geom has been fixed.

  • In Python parameter expressions several errors have been fixed. Now comments and semicolons can’t break one-liners.

  • License Activasion crash has been fixed on Linux.

Minor Bugfixes

  • In FacialAnnotation has been fixed projection bug with Camera’s Nearplane < 0.01.

  • In LoadGeom specific geom loading crash has been fixed.

  • In Node-Graph Editor ALT + LMB crash has been fixed. As well, the bug of removing nodes while moving it or it’s connection has been fixed.

  • In FastWrapping, Wrapping and other nodes with Auto-Compute a problem with no changing flag after closing the node’s editor has been fixed.

  • More detailed error messages of loading and updating projects have been added.

  • In Compute Range a proper error message has been added.

  • In Node-Graph Editor node names generating mistakes has been fixed.

  • In SelectPoints editor several UI problems have been fixed.

  • In SelectPointPairs visual editor missing point updates have been fixed.

  • In SelectPolygons visual editor the problem has been fixed. Display Mode is no more seted to Polygroups when the input geom has no polygroups.

  • In LoadPoints visual editor missing transform bug has been fixed.


  • You can still use your existing R3DS licenses to activate Wrap. If such Nodelocked or Floating licenses would be found on your computer, they would be silently used to activate latest products, if possible. The more accurate scheme is: - If there is a new Faceform license already in the newest Faceform settings, then nothing will change. - If there is no old licenses on your computer, the License Dialog will work as previously. - If there is an old license on your computer, and there are no new, an old license would be taken and used as a new one. - Anytime, running Wrap, you still can go to License >> Activate License to activate new license instead of the old one.

Wrap4D 2021.11.3

Released November 2021

Bug Fixes

  • In Brush node, fixed crash on changing the symmetry mode.

Wrap4D 2021.11.2

Released November 2021


  • Loading Wrap4D projects from a command line added.

  • In search node menu added more prior to first letters and capital letters. For example, searching for “lg” will quickly find LoadGeom node.

Bug Fixes

Wrap4D 2021.11.1

Released November 2021

New Nodes

IconFastWrapping FastWrapping

works up to 20 times faster than a regular Wrapping node. The speedup is especially noticeable on highpoly base meshes

IconPointDetector PointDetector

automatically detects facial markers on FACS scans. Please check this tutorial to see how this node can significantly speed up the point selection process. This video explains how to set up this node to work with your custom topology

IconUnsubdivideGeom UnsubdivideGeom

restores previous subdivision levels for meshes produced using Catmull-Clark subdivision

IconMatchTopology MatchTopology

matches the vertex order of your model with a given reference

IconFindTransform FindTransform

computes transformation between two models with the same topology

IconSaveScreenPoints SaveScreenPoints

saves screen points to a file

IconPointsToScreenPoints PointsToScreenPoints

projects points on a model to screen space

IconLoadPoints LoadPoints

loads points from a file

IconDeltaMush DeltaMush

moves mesh details from reference geometry to target geometry

IconImageToVertexMask ImageToVertexMask

converts an Image into a VertexMask

IconVertexMaskToPolygonSelection VertexMaskToPolygonSelection

converts a VertexMask into a PolygonSelection


  • In SelectPointPairs node: if you select a set of points on one model, clicking Ctrl+F shortcut will fit the camera to the location of the next point on the second model. Please check this tutorial to see how it helps to speed up a point selection process.

  • Added a tooltip panel at the bottom left corner of the viewport and visual editors. It shows a list of shortcuts supported by the current tool. The tooltips are added to SelectPoints, SelectPolygons, SelectPointPairs, Brush, VertexMask, OpticalFlowWrapping, and PointDetector nodes.

  • WrapCmd and Node applications no longer require OpenGL. It makes it easier to run them on a farm and machines without graphics cards. The only nodes that require OpenGL 2.1 to compute are the ExtrapolateImage and Render nodes. When running on machines without graphic cards or with no OpenGL 2.1 available, these nodes will return an error.

  • Viewport3D and VisualEditor now support antialiasing.

  • In SaveGeom and SaveImage nodes have a new Create Intermediate Directories parameter. If it’s turned on, the node will create all the non-existing folders in the file path.

  • In SaveFacialDetection node computation can be performed in multiple parallel processes.

  • Render node has a Show Backfaces option.

  • DeletePolygons has an option to delete selected or non-selected polygons.

  • In MixGeom node: the Mask input parameter is now optional.

  • Added commonDir(), projectDir() and galleryDir() in Python parameter expressions.

  • Improved Temporal Smoothing tool supports Alembic and iterative smoothing.

  • Nodes that have VertexMask as output data type has the ability to save VertexMask from the pop-up menu in the graph editor.

  • When dragging-and-dropping a file into the graph editor a node will take the name of the source file.

  • Improved Preferences dialog.

  • Improved search in node menu.

Bug Fixes

  • In SelectPoints and SelectPointPairs nodes: fixed selection pixel tolerance for 4K screen.

  • In SelectPoints and SelectPointPairs nodes: fixed points selection for transformed meshes.

  • Changing Timeline current frame with Shift now doesn’t force all nodes to recompute.

  • Fixed a bug with saving node colors.

  • In MergeImage node: fixed transparent background bug.

  • In DeletePolygons node: fixed incorrect polygon group mapping.

  • In Wrap4DCmd fixed error tracing.

  • In several nodes, fixed $PROJECT_DIR support.

  • Improved file filters in some nodes that allow to import/export files.

Wrap4D 2020.12.2

Released December 2020


  • When application crashes, it automatically saves its latest state to a crash dump file. A user can then manually send the file to the developers to help them the diagnose problem. The crush dump files can be located at $USERPROFILE/AppData/Local/Faceform/Wrap4D/CrashDumps for Windows, and at $HOME/.local/share/Faceform/Wrap4D/CrashDumps for Linux.

Bug Fixes

  • Fixed incorrect UV winding order when loading meshes from Alembic files.

Wrap4D 2020.12.1

Released December 2020

Bug Fixes

  • In TransferTexture node the value of V parameter is now interpreted as flipped.

Wrap4D 2020.10.2

Released October 2020

Bug Fixes

  • In SelectPolygons the File Name parameter dialog was fixed so that one can specify a file name for not yet created file

Wrap4D 2020.10.1

Released October 2020


  • MixGeom node has a new Blend parameter. It controls the mix amount between the two models.

  • Camera node can now import a camera from Reality Capture and Metashape. For Reality Capture version and earlier the import can be done only from an FBX file. Please check the <ImportCamerasToWrap> documentation for more details.

  • Camera node has a new Principal Point parameter that allows changing the center of the optical axis.

Bug Fixes

  • A memory leak has been fixed in the MixGeom node during loading of files in Draco format. Previously it led to RAM overflow during processing of large sequences in batch mode.

Wrap4D 2020.08

Released 20 August 2020

New Nodes

IconCreateImage CreateImage

creates an empty image object

IconMergeImage MergeImage

merges two images into a single one.

IconReplaceImageChannels ReplaceImageChannels

replaces image channels between two images

IconTextImage TextImage

render text on a transparent image


  • Panel system.