User settings

Some values and settings in V-REP are not dependent on a scene or model, but rather dependent on the user. The user settings dialog (which partially reflects the content of file system/usrset.txt) can be accessed with [Menu bar --> Tools --> Settings] or by clicking following toolbar button:

[Settings toolbar button]


[User settings dialog]


  • Translation step size: the linear step size used when translating objects in the object manipulation mode. It is recommended to keep a value of 5 cm. Objects can be assigned specific step sizes in the coordinate and transformation dialog.
  • Rotation step size: the angular step size used when rotating objects in the object manipulation mode. Objects can be assigned specific step sizes in the coordinate and transformation dialog.
  • Remove identical vertices, tolerance: when selected, vertices that lay nearby other vertices will be grouped to form one single vertex (that will then be shared among surrounding triangles). This reduces the amount of memory resources needed. This parameter is affecting meshes when they are being imported or shapes when leaving the shape edit mode. Tolerance specifies the distance threshold to consider when grouping vertices. In general, keep a low value, but different from zero: some mesh data formats (e.g. STL) assign individual vertices to each triangle, regardless whether a vertex is identical with another vertex in another triangle; this can considerably increase the amount of memory required.
  • Remove identical triangles: when selected, identical triangles in a mesh resource will be removed during an import operation or when a shape leaves the shape edit mode.
  • Ignore triangle winding: a triangle can have two distinct orientations (since it has two distinct faces). When this item is selected, the triangle orientation is ignored when identifying identical triangles.
  • Antialiasing: displays smooth edges, and smooth 2D graph curves/points. This might slow down display and/or create visual artifacts.
  • Display world reference: displays a small world reference frame in the lower left hand side of a camera view. As everywhere in V-REP, the red, green and blue arrows correspond to the x-, y-, and z-axis respectively.
  • Display bounding boxes of selected objects: displays a white/yellow bounding box around selected objects
  • Undo/redo enabled: enables or disables the undo/redo functionality. That functionality operates by serializing (saving) the entire scene to memory every time a change was registered. Only differences with previous undo points are memorized so as to use little memory. This is a very efficient and fail-safe undo/redo that is also supported from plugins or the main client application, and that is permitted only because V-REP's serialization routines are very fast. There are however times when either the computer is really old or the scene content extremely large (e.g. very detailed cad data) where this method slows down the whole application. In that case, simply disable the undo/redo functionality.
  • Hide console window: allows hiding or showing the console window. By default, the console window is hidden. On Mac, this item is not available (the standard output can be viewed in the system console (Applications/Utilities/Console)).
  • Transparent dialogs: allows turning dialogs semi-transparent when they loose focus.
  • Auto-save enabled: when auto-save is enabled, each opened scene will be saved on a regular basis. In case of a crash, the auto-saved scenes can be restored. The auto-save delay can be adjusted in the file system/usrset.txt.
  • Threaded rendering: when enabled, then rendering will run in a separate thread during simulation, effectively accelerating the simulation cycle. Instead of using this check-box, it is recommended to toggle to/from threaded rendering via its dedicated toolbar button.
  • Ask to include script files: instead of holding the code directly, scripts can simply include code from an external file. When this checkbox is enabled, then the save scene as... and save model as... menu items will save the included code instead, making the scene more self-sufficient. This option is cleared at each V-REP launch.
  • External script editor: you can specify an other editor for editing embedded scripts. Changes will only take effect after you restart V-REP (do not forget to save the settings first!).
  • Adjust OpenGL settings: opens a dialog that allows to adjust most settings related to OpenGL:


  • OpenGL settings

    [OpenGL settings dialog]


  • Offscreen context type: the type of the offscreen rendering contexts. Default are invisible windows.
  • FBO type: the type of the frame buffer objects. Default are Qt-based FBOs on Mac, and Non-Qt-based FBOs on Windows and Linux.
  • VBO operation: whether Vertex Buffer Objects are used. The default option uses VBOs.
  • Idle fps: the number of frames per second when idle.


  • Recommended topics

  • Object manipulation mode
  • Coordinate and transformation dialog
  • Mesh import / export
  • Shape edit modes
  • Console window