These pages are no longer maintained. Visit battleaxe.co for up to date docs.

# Controls

Hose and rig controls are found on the end controller (where the majority of keyframing happens) under the effects panel –F3 on the keyboard.

The hose controls are where characters become your own. Don't just accept the preset values, find the perfect balance of smush and snap to bring your folks to life.

# Hose length

RH2 hose length

The main concept behind RubberHose is that a hose bends based on its length. A hose can be stretched beyond its defined length, but once the distance between controllers is less than the Hose Length, the hose is forced to bend to get out of the way.


# Bend radius

RH2 bend radius

Control how sharp or curved the bend is (or anywhere in-between).

  • 0: straight lines with a single bend point
  • 100: fully curved line with the bend spread across the whole hose.

Bend Radius can be pushed into negative numbers to create an overlapped loop, or past 100 to exaggerate roundness.


# Realism

RH2 realism

Anyone familiar with traditional IK knows well the snap that happens when a limb goes from bent to straight. This is 100% physically accurate, but accuracy isn't always appropriate in animation.

With the Realism value you dial in how true to reality or soft and squishy you want the hose to straighten.


# Bend direction

RH2 bend direction

The direction or a bend is fully customizable and animatable. Set the direction at the start of animation and feel free to change the direction as you work. The transition from one side to another is taken care of for you.

The intermediate values between -100 and 100 can be helpful when a character's move must be pushed into perspective. This foreshortening effect could be accomplished with a reduction of the Hose Length, but is easier controlled by thinking of the Bend Direction as a kind of multiplier.


# Auto rotate

RH2 auto rotate

Each hose has 2 controllers. Controllers may be parented to layers and layers may be parented to hose controllers. Parenting hands to the end of a hose may benefit from a controller rotating based on the bend radius of the hose. Disabling automatic rotation will save a small bit of render-time.

Controllers may be rotated and keyframed like normal β€”the automatic rotation value is added to keyframe values.


# Stretch feedback

RH2 stretch feedback

In order to provide as much flexibility as possible (yes, pun intended), hoses may stretch to any length beyond their Hose Length. As a friendly reminder that a stretch is happening, the controllers will change color. It's a small thing but could be very helpful for preserving the volume of a hose.

If you don't care about this then feel free to disable Stretch Feedback in settings.


# Math stuff

RH2 math stuff

This is the spot dedicated to doing most of the fancy math that makes RubberHose work. Don't mess with this stuff. Seriously.


# Center bias

RH2 center bias

RubberRig and RubberPin both feature the ability to move the center point, but they aren't trying to draw a bendy shape layer (which makes things complicated). Creating this effect on a RubberHose layer is made possible by distorting the underlying shape but isn't as mathematically correct as the other systems.

This is still an experimental feature and may be enabled within settings. It's experimental because it currently causes some other features to break. Controller auto rotation will not be completely accurate, added centerpoints will not line up and complex styles tend to fall apart or get distorted. Be warned!!! πŸ¦‚