## IpatchGigInst IpatchGigInst — GigaSampler instrument object |

## Stability Level

Stable, unless otherwise indicated

## Synopsis

                        IpatchGigInstParams;
                        IpatchGigInst;
    IpatchGigInst *     ipatch_gig_inst_new                 (void);
    IpatchGigInst *     ipatch_gig_inst_first               (IpatchIter *iter);
    IpatchGigInst *     ipatch_gig_inst_next                (IpatchIter *iter);

## Object Hierarchy

      GObject
       +----IpatchItem
             +----IpatchContainer
                   +----IpatchDLS2Inst
                         +----IpatchGigInst

## Description

GigaSampler instrument objects are the toplevel instrument objects in a GigaSampler file.

## Details

### IpatchGigInstParams

    typedef struct _IpatchGigInstParams IpatchGigInstParams;

### IpatchGigInst

    typedef struct _IpatchGigInst IpatchGigInst;

### ipatch_gig_inst_new ()

    IpatchGigInst *     ipatch_gig_inst_new                 (void);

Create a new GigaSampler instrument object.

Returns : | New GigaSampler instrument with a reference count of 1. Caller owns the reference and removing it will destroy the item, unless another reference is added (if its parented for example).

### ipatch_gig_inst_first ()

    IpatchGigInst *     ipatch_gig_inst_first               (IpatchIter *iter);

Gets the first item in a GigaSampler instrument iterator. A convenience wrapper for `ipatch_iter_first()`.

`iter` : | Patch item iterator containing IpatchGigInst items
Returns : | The first GigaSampler instrument in `iter` or `NULL` if empty.

### ipatch_gig_inst_next ()

    IpatchGigInst *     ipatch_gig_inst_next                (IpatchIter *iter);

Gets the next item in a GigaSampler instrument iterator. A convenience wrapper for `ipatch_iter_next()`.

`iter` : | Patch item iterator containing IpatchGigInst items
Returns : | The next GigaSampler instrument in `iter` or `NULL` if at the end of the list.