RotateBrush(id, angle[, factorx, factory, smooth])

Starting with Hollywood 2.5, this function can also scale the brush while rotating it (called a rot-zoom). This is done in one pass so the quality of the resulting image data is much better than if you would first call ScaleBrush() and then RotateBrush(). If you want to have the brush scaled with the rotation, simply pass two scaling factors as factorx and factory. These two factors are floating point numbers representing a zoom percentage (1 corresponds to 100%, 0.5 to 50%, 1.5 to 150% etc.)

Additionally, you can choose to have the scaled and/or rotated graphics interpolated by passing True in the smooth argument. The graphics will then be scaled/rotated using anti-alias.

Please note:

• – If you rotate a brush for instance by a 45 degree angle and your brush does not have a mask, Hollywood will automatically create a mask for this brush because the rotate operation usually leads to some unused areas in the brush. If your brush has a mask, then Hollywood will rotate this mask also.

• – You should not rotate a rotated brush again because this will lead to loss of data! You should always use the original brush when creating rotated versions of the brush, e.g. if you rotate a brush by 45 degrees and then rotate it back by -45 degrees, the resulting brush will not be of the same quality as the original one.

• – Note that for vector brushes, RotateBrush() will always operate on the untransformed brush. This means that any previous transformations applied to the brush using RotateBrush(), ScaleBrush(), or TransformBrush() will be undone when calling RotateBrush().

id

brush to rotate

angle

rotation angle in degrees

factorx

optional: scaling factor on the x-axis (defaults to 1 which means no x scaling) (V2.5)

factory

optional: scaling factor on the y-axis (defaults to 1 which means no y scaling) (V2.5)

smooth

optional: whether or not anti-aliased rotation shall be used (V2.5)