Snug - acidbubbles/vam-embody GitHub Wiki

Snug Screen

Fields marked with a * suffix will be loaded from your profile rather than from the scene if the Use Profile toggle is on.

Identifies the VR model proportions, and displaces the VR hands so they fit your own body. For example, touching your navel in reality should also touch the VR model navel, even though it may have different proportions.

This should provide improved realism when touching your own body while possessing a person in Virt-A-Mate.

How to use

Activate Snug in the main menu. You can now open the Snug Settings, and select Preview Offset; you should see rings appear. Those are "anchors", which represents the virtual model proportions compared to yours.

World scale should be configured correctly, until your arms stretch horizontally naturally (the model shouldn't look like the arms are being teared of, nor be too bended when yours are extended).

Now to adjust to your own body proportions. For each anchor, adjust the "Size" and "Scale" values until the rings fit with your own body size (doesn't need to be ultra precise). For example, if you touch your own navel, the abdomen anchor (white) should touch your controller's position.

You should see a yellow line connecting your controller to the "adjusted" controller position, where the VR hand will be. This is only to help visualize the displacement.

You can now proceed with possessing the model. First, uncheck the Preview Offset toggle. Then, activate Embody.

You can make some adjustments to your hand rotation too in the Trackers screen.

You should now be able to interact with your own body, and have the virtual model do the same thing even though your proportions differ!

Options

Left Column

  • Anchor represents a vertical position on your body; the VR person ring (white) will automatically be adjusted, and you can adjust your own proportions ring (yellow) for each.
  • Size X/Z represents how "large" you are in reality.
  • Offset X/Y/Z allows you to adjust vertical proportion differences. For example, if you hips are lower than the model's because they have longer legs, you can adjust the Offset Y to compensate; this can also help when you have "long arms", so your "relaxed position" also look relaxed in VR. Note that the Z offset is used to adjust the center of your body, while the Size Z slider let's you change your "depth"; unless you have your hands behind your back, both will do pretty much the same thing, except that Offset will also move your hands forward if you adjust Offset Z.

Right Column

  • Use Profile will use your saved profile when loading this scene rather than the current values. Leave this one to allow other people to load with different settings.
  • Preview Offset will show the white (VR) and yellow (real) rings, as well as a line showing how the VR hand will be translated depending on where your hand sare.
  • Falloff Distance dictates the rate at which the "pull effect" will be lowered when your hands get further from your body. A larger distance will be smoother, but may affect your hands while far from your body.
  • Falloff Mid-point determines the falloff curve. Lower mid-point values means the effect strength will drop dramatically with distance, high values will make the effect stay high until near the falloff limit.

Videos

With and without Snug:

With and without Snug

Note that those videos were made with the "old" Snug, but the principles should still apply, except that the "VR proportions" are automatically configured in Embody.

Snug standing tutorial:

Snug Standing Tutorial

Snug sitting tutorial:

Snug Sitting Tutorial

History

This was initially a separate project: Snug on Virt-A-Mate Hub