# Tweak

Adjust a knob in an instrument

### Synopsis

`Tweak <instrument> <knob> <value>`

### Arguments

<instrument>
  Symbol name of an instrument containing the knob to adjust.

<knob>
  Name of the knob to adjust.

<value>
  New raw value for <knob>. Every knob has its own range of values. See Chapter 12 in the Portfolio Reference Manual for a complete list. A value with a leading 0 is treated as octal. A value with a leading 0x is treated as hexadecimal. Otherwise values are treated as decimal.

### Examples

The following example shows a patch file that uses `Tweak`.

``

    Tweak osc Frequency 4000                                ; Set Frequency knob to 4000
                                    ; Raw value not Hz *.
    Tweak osc Amplitude 0x7fff                                ; Set Amplitude knob to                                     32767

                                    ; (7FFF hex).
    Tweak osc PulseWidth -100                                ; Set PulseWidth knob to -100.*
    See PRG 332-333 in the Portfolio Programmer's Guide for more
    information on raw values.

### Note

If a value is out of range it will be brought into range.

### See Also

`LoadInstrument, Connect`