Defines Region information of an Instrument. More...

#include <DLS.h>

Inheritance diagram for DLS::Region:

Public Member Functions
Sample *	GetSample ()

void	SetSample (Sample *pSample)
	Assign another sample to this Region. More...

virtual void	SetKeyRange (uint16_t Low, uint16_t High)
	Modifies the key range of this Region and makes sure the respective chunks are in correct order. More...

virtual void	UpdateChunks (progress_t *pProgress)
	Apply Region settings to the respective RIFF chunks. More...

virtual void	DeleteChunks ()
	Remove all RIFF chunks associated with this Region object. More...

virtual void	CopyAssign (const Region *orig)
	Make a (semi) deep copy of the Region object given by orig and assign it to this object. More...

Resource *	GetParent ()

const Resource *	GetParent () const

void	GenerateDLSID ()
	Generates a new DLSID for the resource.

virtual void	CopyAssign (const Resource *orig)
	Make a deep copy of the Resource object given by orig and assign it to this object. More...

Articulation *	GetFirstArticulation ()

Articulation *	GetNextArticulation ()

virtual void	CopyAssign (const Articulator *orig)
	Not yet implemented in this version, since the .gig format does not need to copy DLS articulators and so far nobody used pure DLS instrument AFAIK.

void	AddSampleLoop (sample_loop_t *pLoopDef)
	Adds a new sample loop with the provided loop definition. More...

void	DeleteSampleLoop (sample_loop_t *pLoopDef)
	Deletes an existing sample loop. More...

virtual void	SetGain (int32_t gain)

virtual void	CopyAssign (const Sampler *orig)
	Make a deep copy of the Sampler object given by orig and assign it to this object. More...

Static Public Member Functions
static void	GenerateDLSID (dlsid_t *pDLSID)

Public Attributes
range_t	KeyRange

range_t	VelocityRange

uint16_t	KeyGroup

uint16_t	Layer

bool	SelfNonExclusive

bool	PhaseMaster

uint16_t	PhaseGroup

bool	MultiChannel

uint32_t	Channel

Info *	pInfo
	Points (in any case) to an Info object, providing additional, optional infos and comments.

dlsid_t *	pDLSID
	Points to a dlsid_t structure if the file provided a DLS ID else is NULL.

uint8_t	UnityNote

int16_t	FineTune

int32_t	Gain

bool	NoSampleDepthTruncation

bool	NoSampleCompression

uint32_t	SampleLoops
	Reflects the number of sample loops.

sample_loop_t *	pSampleLoops
	Points to the beginning of a sample loop array, or is NULL if there are no loops defined.

Protected Types
typedef std::list< Articulation * >	ArticulationList

Protected Member Functions
	Region (Instrument pInstrument, RIFF::List rgnList)

virtual	~Region ()
	Destructor. More...

void	LoadArticulations ()

Protected Attributes
RIFF::List *	pCkRegion

uint32_t	WavePoolTableIndex

Sample *	pSample

uint16_t	FormatOptionFlags

uint16_t	WaveLinkOptionFlags

Resource *	pParent

RIFF::List *	pResourceList

RIFF::List *	pParentList

ArticulationList *	pArticulations

ArticulationList::iterator	ArticulationsIterator

RIFF::List *	pParentList

uint32_t	uiHeaderSize

uint32_t	SamplerOptions

Detailed Description

Defines Region information of an Instrument.

Definition at line 492 of file DLS.h.

Constructor & Destructor Documentation

◆ ~Region()

DLS::Region::~Region ( )

protectedvirtual

Destructor.

Intended to free up all memory occupied by this Region object. ATM this destructor implementation does nothing though.

Reimplemented in gig::Region.

Definition at line 1141 of file DLS.cpp.

Member Function Documentation

◆ AddSampleLoop()

void DLS::Sampler::AddSampleLoop ( sample_loop_t * pLoopDef )

inherited

Adds a new sample loop with the provided loop definition.

Parameters

pLoopDef - points to a loop definition that is to be copied

Definition at line 706 of file DLS.cpp.

References DLS::Sampler::pSampleLoops, DLS::Sampler::SampleLoops, and DLS::sample_loop_t::Size.

◆ CopyAssign() [1/3]

void DLS::Region::CopyAssign ( const Region * orig )

virtual

Make a (semi) deep copy of the Region object given by orig and assign it to this object.

Note that the sample pointer referenced by orig is simply copied as memory address. Thus the respective sample is shared, not duplicated!

Parameters

orig	- original Region object to be copied from

Definition at line 1288 of file DLS.cpp.

References DLS::Articulator::CopyAssign(), DLS::Resource::CopyAssign(), DLS::Sampler::CopyAssign(), DLS::range_t::high, KeyRange, DLS::range_t::low, and SetKeyRange().

Referenced by DLS::Instrument::CopyAssign(), and gig::Region::CopyAssign().

◆ CopyAssign() [2/3]

void Resource::CopyAssign ( const Resource * orig )

virtualinherited

Make a deep copy of the Resource object given by orig and assign it to this object.

Parameters

orig	- original Resource object to be copied from

Definition at line 601 of file DLS.cpp.

References DLS::Info::CopyAssign(), and DLS::Resource::pInfo.

Referenced by CopyAssign(), and DLS::Sample::CopyAssignCore().

◆ CopyAssign() [3/3]

void DLS::Sampler::CopyAssign ( const Sampler * orig )

virtualinherited

Make a deep copy of the Sampler object given by orig and assign it to this object.

Parameters

orig	- original Sampler object to be copied from

Definition at line 752 of file DLS.cpp.

References DLS::Sampler::Gain, DLS::Sampler::pSampleLoops, and DLS::Sampler::SampleLoops.

Referenced by CopyAssign().

◆ DeleteChunks()

void DLS::Region::DeleteChunks ( )

virtual

Remove all RIFF chunks associated with this Region object.

See Storage::DeleteChunks() for details.

Reimplemented from DLS::Articulator.

Definition at line 1148 of file DLS.cpp.

References DLS::Articulator::DeleteChunks(), DLS::Resource::DeleteChunks(), DLS::Sampler::DeleteChunks(), RIFF::List::DeleteSubChunk(), and RIFF::Chunk::GetParent().

Referenced by gig::Region::DeleteDimensionZone(), and gig::Region::SplitDimensionZone().

◆ DeleteSampleLoop()

void DLS::Sampler::DeleteSampleLoop ( sample_loop_t * pLoopDef )

inherited

Deletes an existing sample loop.

Parameters

pLoopDef - pointer to existing loop definition

Exceptions

Exception - if given loop definition does not exist

Definition at line 728 of file DLS.cpp.

References DLS::Sampler::pSampleLoops, and DLS::Sampler::SampleLoops.

◆ SetKeyRange()

void DLS::Region::SetKeyRange	(	uint16_t	Low,
		uint16_t	High
	)

virtual

Modifies the key range of this Region and makes sure the respective chunks are in correct order.

Parameters

Low	- lower end of key range
High	- upper end of key range

Reimplemented in gig::Region.

Definition at line 1191 of file DLS.cpp.

References DLS::range_t::high, KeyRange, and DLS::range_t::low.

Referenced by CopyAssign(), and gig::Region::SetKeyRange().

◆ SetSample()

void DLS::Region::SetSample ( Sample * pSample )

Assign another sample to this Region.

Parameters

pSample - sample to be assigned

Definition at line 1179 of file DLS.cpp.

◆ UpdateChunks()

void DLS::Region::UpdateChunks ( progress_t * pProgress )

virtual

Apply Region settings to the respective RIFF chunks.

You have to call File::Save() to make changes persistent.

Parameters

pProgress - callback function for progress notification

Exceptions

Exception - if the Region's sample could not be found

Reimplemented from DLS::Articulator.

Reimplemented in gig::Region.

Definition at line 1226 of file DLS.cpp.

References RIFF::List::AddSubChunk(), RIFF::Chunk::GetSize(), RIFF::List::GetSubChunk(), DLS::range_t::high, KeyRange, RIFF::Chunk::LoadChunkData(), DLS::range_t::low, DLS::Articulator::UpdateChunks(), and DLS::Sampler::UpdateChunks().

Referenced by gig::Region::UpdateChunks().

Member Data Documentation

◆ Gain

int32_t DLS::Sampler::Gain

inherited

Deprecated:: Don't alter directly, use SetGain() instead!

Definition at line 428 of file DLS.h.

Referenced by DLS::Sampler::CopyAssign(), gig::DimensionRegion::SetGain(), and DLS::Sampler::UpdateChunks().

◆ KeyRange

range_t DLS::Region::KeyRange

Deprecated:: Only read, don't write! Use SetKeyRange() instead.

Definition at line 494 of file DLS.h.

Referenced by CopyAssign(), SetKeyRange(), and UpdateChunks().

The documentation for this class was generated from the following files:

Public Member Functions

Static Public Member Functions

Public Attributes

Protected Types

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ ~Region()

Member Function Documentation

◆ AddSampleLoop()

◆ CopyAssign() [1/3]

◆ CopyAssign() [2/3]

◆ CopyAssign() [3/3]

◆ DeleteChunks()

◆ DeleteSampleLoop()

◆ SetKeyRange()

◆ SetSample()

◆ UpdateChunks()

Member Data Documentation

◆ Gain

◆ KeyRange