###### RMagick 2.13.2 User's Guide and Reference

# class RVG::Use < Object

## class methods

### new

RVG::Use.new(obj, x=0, y=0, width=nil, height=nil)-> use

#### Description

This method is usually invoked indirectly via the `use` method in the RVG, RVG::ClipPath, RVG::Group, and RVG::Pattern classes.

The use object is similar to a group. Any styles specified on the use will propagate to the referenced object. However, styles on the referenced object will override the styles specified on the RVG::Use object.

#### Arguments

obj
  The object to be re-used. This is typically a group or RVG object but can also be any shape, text, or raster image, or even another `use`.
x, y
  These arguments can be used to specify an additional translate transformation to be applied to the object within the user coordinate system.
width, height
  The width and height of the rectangular region in which this object is placed. These arguments are ignored unless object is an RVG object. In this case, the values of width and height override the values of the width and height arguments that were specified when the RVG object was created.

#### Example

A simple 'use' on a 'rect'

What happens when a 'use' has chained transform methods

What happens when a 'use' has a chained 'style' method

Also see the example for RVG.new and the example for RVG::Group.new.