engines/gig/InstrumentResourceManager.cpp

/***************************************************************************
 *                                                                         *
 *   LinuxSampler - modular, streaming capable sampler                     *
 *                                                                         *
 *   Copyright (C) 2003, 2004 by Benno Senoner and Christian Schoenebeck   *
 *   Copyright (C) 2005 Christian Schoenebeck                              *
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 *   This program is distributed in the hope that it will be useful,       *
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
 *   GNU General Public License for more details.                          *
 *                                                                         *
 *   You should have received a copy of the GNU General Public License     *
 *   along with this program; if not, write to the Free Software           *
 *   Foundation, Inc., 59 Temple Place, Suite 330, Boston,                 *
 *   MA  02111-1307  USA                                                   *
 ***************************************************************************/

#include <sstream>

#include "InstrumentResourceManager.h"

// We need to know the maximum number of sample points which are going to
// be processed for each render cycle of the audio output driver, to know
// how much initial sample points we need to cache into RAM. If the given
// sampler channel does not have an audio output device assigned yet
// though, we simply use this default value.
#define GIG_RESOURCE_MANAGER_DEFAULT_MAX_SAMPLES_PER_CYCLE     128

namespace LinuxSampler { namespace gig {

    // some data needed for the libgig callback function
    struct progress_callback_arg_t {
        InstrumentResourceManager* pManager;
        instrument_id_t*           pInstrumentKey;
    };

    /**
     * Callback function which will be called by libgig during loading of
     * instruments to inform about the current progress. Or to be more
     * specific; it will be called during the GetInstrument() call.
     *
     * @param pProgress - contains current progress value, pointer to the
     *                    InstrumentResourceManager instance and
     *                    instrument ID
     */
    void InstrumentResourceManager::OnInstrumentLoadingProgress(::gig::progress_t* pProgress) {
        dmsg(7,("gig::InstrumentResourceManager: progress %f%", pProgress->factor));
        progress_callback_arg_t* pArg = static_cast<progress_callback_arg_t*>(pProgress->custom);
        // we randomly schedule 90% for the .gig file loading and the remaining 10% later for sample caching
        const float localProgress = 0.9f * pProgress->factor;
        pArg->pManager->DispatchResourceProgressEvent(*pArg->pInstrumentKey, localProgress);
    }

    ::gig::Instrument* InstrumentResourceManager::Create(instrument_id_t Key, InstrumentConsumer* pConsumer, void*& pArg) {
        // get gig file from inernal gig file manager
        ::gig::File* pGig = Gigs.Borrow(Key.FileName, (GigConsumer*) Key.iInstrument); // conversion kinda hackish :/

        // we pass this to the progress callback mechanism of libgig
        progress_callback_arg_t callbackArg;
        callbackArg.pManager       = this;
        callbackArg.pInstrumentKey = &Key;

        ::gig::progress_t progress;
        progress.callback = OnInstrumentLoadingProgress;
        progress.custom   = &callbackArg;

        dmsg(1,("Loading gig instrument..."));
        ::gig::Instrument* pInstrument = pGig->GetInstrument(Key.iInstrument, &progress);
        if (!pInstrument) {
            std::stringstream msg;
            msg << "There's no instrument with index " << Key.iInstrument << ".";
            throw InstrumentResourceManagerException(msg.str());
        }
        pGig->GetFirstSample(); // just to force complete instrument loading
        dmsg(1,("OK\n"));

        // cache initial samples points (for actually needed samples)
        dmsg(1,("Caching initial samples..."));
        uint iRegion = 0; // just for progress calculation
        ::gig::Region* pRgn = pInstrument->GetFirstRegion();
        while (pRgn) {
            // we randomly schedule 90% for the .gig file loading and the remaining 10% now for sample caching
            const float localProgress = 0.9f + 0.1f * (float) iRegion / (float) pInstrument->Regions;
            DispatchResourceProgressEvent(Key, localProgress);            
            
            if (pRgn->GetSample() && !pRgn->GetSample()->GetCache().Size) {
                dmsg(2,("C"));
                CacheInitialSamples(pRgn->GetSample(), dynamic_cast<gig::EngineChannel*>(pConsumer));
            }
            for (uint i = 0; i < pRgn->DimensionRegions; i++) {
                CacheInitialSamples(pRgn->pDimensionRegions[i]->pSample, dynamic_cast<gig::EngineChannel*>(pConsumer));
            }

            pRgn = pInstrument->GetNextRegion();
            iRegion++;
        }
        dmsg(1,("OK\n"));
        DispatchResourceProgressEvent(Key, 1.0f); // done; notify all consumers about progress 100%

        // we need the following for destruction later
        instr_entry_t* pEntry = new instr_entry_t;
        pEntry->iInstrument   = Key.iInstrument;
        pEntry->pGig          = pGig;

        gig::EngineChannel* pEngineChannel = dynamic_cast<gig::EngineChannel*>(pConsumer);
        // and we save this to check if we need to reallocate for a engine with higher value of 'MaxSamplesPerSecond'
        pEntry->MaxSamplesPerCycle =
            (pEngineChannel->GetEngine()) ? dynamic_cast<gig::Engine*>(pEngineChannel->GetEngine())->pAudioOutputDevice->MaxSamplesPerCycle()
                                          : GIG_RESOURCE_MANAGER_DEFAULT_MAX_SAMPLES_PER_CYCLE;
        pArg = pEntry;

        return pInstrument;
    }

    void InstrumentResourceManager::Destroy( ::gig::Instrument* pResource, void* pArg) {
        instr_entry_t* pEntry = (instr_entry_t*) pArg;
        Gigs.HandBack(pEntry->pGig, (GigConsumer*) pEntry->iInstrument); // conversion kinda hackish :/
        delete pEntry;
    }

    void InstrumentResourceManager::OnBorrow(::gig::Instrument* pResource, InstrumentConsumer* pConsumer, void*& pArg) {
        instr_entry_t* pEntry = (instr_entry_t*) pArg;
        gig::EngineChannel* pEngineChannel = dynamic_cast<gig::EngineChannel*>(pConsumer);
        uint maxSamplesPerCycle =
            (pEngineChannel->GetEngine()) ? dynamic_cast<gig::Engine*>(pEngineChannel->GetEngine())->pAudioOutputDevice->MaxSamplesPerCycle()
                                          : GIG_RESOURCE_MANAGER_DEFAULT_MAX_SAMPLES_PER_CYCLE;
        if (pEntry->MaxSamplesPerCycle < maxSamplesPerCycle) {
            Update(pResource, pConsumer);
        }
    }

    /**
     *  Caches a certain size at the beginning of the given sample in RAM. If the
     *  sample is very short, the whole sample will be loaded into RAM and thus
     *  no disk streaming is needed for this sample. Caching an initial part of
     *  samples is needed to compensate disk reading latency.
     *
     *  @param pSample - points to the sample to be cached
     *  @param pEngineChannel - pointer to Gig Engine Channel which caused this call
     */
    void InstrumentResourceManager::CacheInitialSamples(::gig::Sample* pSample, gig::EngineChannel* pEngineChannel) {
        if (!pSample) {
            dmsg(4,("gig::InstrumentResourceManager: Skipping sample (pSample == NULL)\n"));
            return;
        }
        if (!pSample->SamplesTotal) return; // skip zero size samples

        if (pSample->SamplesTotal <= CONFIG_PRELOAD_SAMPLES) {
            // Sample is too short for disk streaming, so we load the whole
            // sample into RAM and place 'pAudioIO->FragmentSize << CONFIG_MAX_PITCH'
            // number of '0' samples (silence samples) behind the official buffer
            // border, to allow the interpolator do it's work even at the end of
            // the sample.
            const uint maxSamplesPerCycle =
                (pEngineChannel->GetEngine()) ? dynamic_cast<gig::Engine*>(pEngineChannel->GetEngine())->pAudioOutputDevice->MaxSamplesPerCycle()
                                              : GIG_RESOURCE_MANAGER_DEFAULT_MAX_SAMPLES_PER_CYCLE;
            const uint neededSilenceSamples = (maxSamplesPerCycle << CONFIG_MAX_PITCH) + 3;
            const uint currentlyCachedSilenceSamples = pSample->GetCache().NullExtensionSize / pSample->FrameSize;
            if (currentlyCachedSilenceSamples < neededSilenceSamples) {
                dmsg(3,("Caching whole sample (sample name: \"%s\", sample size: %d)\n", pSample->pInfo->Name.c_str(), pSample->SamplesTotal));
                ::gig::buffer_t buf = pSample->LoadSampleDataWithNullSamplesExtension(neededSilenceSamples);
                dmsg(4,("Cached %d Bytes, %d silence bytes.\n", buf.Size, buf.NullExtensionSize));
            }
        }
        else { // we only cache CONFIG_PRELOAD_SAMPLES and stream the other sample points from disk
            if (!pSample->GetCache().Size) pSample->LoadSampleData(CONFIG_PRELOAD_SAMPLES);
        }

        if (!pSample->GetCache().Size) std::cerr << "Unable to cache sample - maybe memory full!" << std::endl << std::flush;
    }


    // internal gig file manager

    ::gig::File* InstrumentResourceManager::GigResourceManager::Create(String Key, GigConsumer* pConsumer, void*& pArg) {
        dmsg(1,("Loading gig file \'%s\'...", Key.c_str()));
        ::RIFF::File* pRIFF = new ::RIFF::File(Key);
        ::gig::File* pGig   = new ::gig::File(pRIFF);
        pArg                = pRIFF;
        dmsg(1,("OK\n"));
        return pGig;
    }

    void InstrumentResourceManager::GigResourceManager::Destroy(::gig::File* pResource, void* pArg) {
        dmsg(1,("Freeing gig file from memory..."));
        delete pResource;
        delete (::RIFF::File*) pArg;
        dmsg(1,("OK\n"));
    }

}} // namespace LinuxSampler::gig
1	/***************************************************************************
2	* *
3	* LinuxSampler - modular, streaming capable sampler *
4	* *
5	* Copyright (C) 2003, 2004 by Benno Senoner and Christian Schoenebeck *
6	* Copyright (C) 2005 Christian Schoenebeck *
7	* *
8	* This program is free software; you can redistribute it and/or modify *
9	* it under the terms of the GNU General Public License as published by *
10	* the Free Software Foundation; either version 2 of the License, or *
11	* (at your option) any later version. *
12	* *
13	* This program is distributed in the hope that it will be useful, *
14	* but WITHOUT ANY WARRANTY; without even the implied warranty of *
15	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
16	* GNU General Public License for more details. *
17	* *
18	* You should have received a copy of the GNU General Public License *
19	* along with this program; if not, write to the Free Software *
20	* Foundation, Inc., 59 Temple Place, Suite 330, Boston, *
21	* MA 02111-1307 USA *
22	***************************************************************************/
23
24	#include <sstream>
25
26	#include "InstrumentResourceManager.h"
27
28	// We need to know the maximum number of sample points which are going to
29	// be processed for each render cycle of the audio output driver, to know
30	// how much initial sample points we need to cache into RAM. If the given
31	// sampler channel does not have an audio output device assigned yet
32	// though, we simply use this default value.
33	#define GIG_RESOURCE_MANAGER_DEFAULT_MAX_SAMPLES_PER_CYCLE 128
34
35	namespace LinuxSampler { namespace gig {
36
37	// some data needed for the libgig callback function
38	struct progress_callback_arg_t {
39	InstrumentResourceManager* pManager;
40	instrument_id_t* pInstrumentKey;
41	};
42
43	/**
44	* Callback function which will be called by libgig during loading of
45	* instruments to inform about the current progress. Or to be more
46	* specific; it will be called during the GetInstrument() call.
47	*
48	* @param pProgress - contains current progress value, pointer to the
49	* InstrumentResourceManager instance and
50	* instrument ID
51	*/
52	void InstrumentResourceManager::OnInstrumentLoadingProgress(::gig::progress_t* pProgress) {
53	dmsg(7,("gig::InstrumentResourceManager: progress %f%", pProgress->factor));
54	progress_callback_arg_t* pArg = static_cast<progress_callback_arg_t*>(pProgress->custom);
55	// we randomly schedule 90% for the .gig file loading and the remaining 10% later for sample caching
56	const float localProgress = 0.9f * pProgress->factor;
57	pArg->pManager->DispatchResourceProgressEvent(*pArg->pInstrumentKey, localProgress);
58	}
59
60	::gig::Instrument* InstrumentResourceManager::Create(instrument_id_t Key, InstrumentConsumer* pConsumer, void*& pArg) {
61	// get gig file from inernal gig file manager
62	::gig::File* pGig = Gigs.Borrow(Key.FileName, (GigConsumer*) Key.iInstrument); // conversion kinda hackish :/
63
64	// we pass this to the progress callback mechanism of libgig
65	progress_callback_arg_t callbackArg;
66	callbackArg.pManager = this;
67	callbackArg.pInstrumentKey = &Key;
68
69	::gig::progress_t progress;
70	progress.callback = OnInstrumentLoadingProgress;
71	progress.custom = &callbackArg;
72
73	dmsg(1,("Loading gig instrument..."));
74	::gig::Instrument* pInstrument = pGig->GetInstrument(Key.iInstrument, &progress);
75	if (!pInstrument) {
76	std::stringstream msg;
77	msg << "There's no instrument with index " << Key.iInstrument << ".";
78	throw InstrumentResourceManagerException(msg.str());
79	}
80	pGig->GetFirstSample(); // just to force complete instrument loading
81	dmsg(1,("OK\n"));
82
83	// cache initial samples points (for actually needed samples)
84	dmsg(1,("Caching initial samples..."));
85	uint iRegion = 0; // just for progress calculation
86	::gig::Region* pRgn = pInstrument->GetFirstRegion();
87	while (pRgn) {
88	// we randomly schedule 90% for the .gig file loading and the remaining 10% now for sample caching
89	const float localProgress = 0.9f + 0.1f * (float) iRegion / (float) pInstrument->Regions;
90	DispatchResourceProgressEvent(Key, localProgress);
91
92	if (pRgn->GetSample() && !pRgn->GetSample()->GetCache().Size) {
93	dmsg(2,("C"));
94	CacheInitialSamples(pRgn->GetSample(), dynamic_cast<gig::EngineChannel*>(pConsumer));
95	}
96	for (uint i = 0; i < pRgn->DimensionRegions; i++) {
97	CacheInitialSamples(pRgn->pDimensionRegions[i]->pSample, dynamic_cast<gig::EngineChannel*>(pConsumer));
98	}
99
100	pRgn = pInstrument->GetNextRegion();
101	iRegion++;
102	}
103	dmsg(1,("OK\n"));
104	DispatchResourceProgressEvent(Key, 1.0f); // done; notify all consumers about progress 100%
105
106	// we need the following for destruction later
107	instr_entry_t* pEntry = new instr_entry_t;
108	pEntry->iInstrument = Key.iInstrument;
109	pEntry->pGig = pGig;
110
111	gig::EngineChannel* pEngineChannel = dynamic_cast<gig::EngineChannel*>(pConsumer);
112	// and we save this to check if we need to reallocate for a engine with higher value of 'MaxSamplesPerSecond'
113	pEntry->MaxSamplesPerCycle =
114	(pEngineChannel->GetEngine()) ? dynamic_cast<gig::Engine*>(pEngineChannel->GetEngine())->pAudioOutputDevice->MaxSamplesPerCycle()
115	: GIG_RESOURCE_MANAGER_DEFAULT_MAX_SAMPLES_PER_CYCLE;
116	pArg = pEntry;
117
118	return pInstrument;
119	}
120
121	void InstrumentResourceManager::Destroy( ::gig::Instrument* pResource, void* pArg) {
122	instr_entry_t* pEntry = (instr_entry_t*) pArg;
123	Gigs.HandBack(pEntry->pGig, (GigConsumer*) pEntry->iInstrument); // conversion kinda hackish :/
124	delete pEntry;
125	}
126
127	void InstrumentResourceManager::OnBorrow(::gig::Instrument* pResource, InstrumentConsumer* pConsumer, void*& pArg) {
128	instr_entry_t* pEntry = (instr_entry_t*) pArg;
129	gig::EngineChannel* pEngineChannel = dynamic_cast<gig::EngineChannel*>(pConsumer);
130	uint maxSamplesPerCycle =
131	(pEngineChannel->GetEngine()) ? dynamic_cast<gig::Engine*>(pEngineChannel->GetEngine())->pAudioOutputDevice->MaxSamplesPerCycle()
132	: GIG_RESOURCE_MANAGER_DEFAULT_MAX_SAMPLES_PER_CYCLE;
133	if (pEntry->MaxSamplesPerCycle < maxSamplesPerCycle) {
134	Update(pResource, pConsumer);
135	}
136	}
137
138	/**
139	* Caches a certain size at the beginning of the given sample in RAM. If the
140	* sample is very short, the whole sample will be loaded into RAM and thus
141	* no disk streaming is needed for this sample. Caching an initial part of
142	* samples is needed to compensate disk reading latency.
143	*
144	* @param pSample - points to the sample to be cached
145	* @param pEngineChannel - pointer to Gig Engine Channel which caused this call
146	*/
147	void InstrumentResourceManager::CacheInitialSamples(::gig::Sample* pSample, gig::EngineChannel* pEngineChannel) {
148	if (!pSample) {
149	dmsg(4,("gig::InstrumentResourceManager: Skipping sample (pSample == NULL)\n"));
150	return;
151	}
152	if (!pSample->SamplesTotal) return; // skip zero size samples
153
154	if (pSample->SamplesTotal <= CONFIG_PRELOAD_SAMPLES) {
155	// Sample is too short for disk streaming, so we load the whole
156	// sample into RAM and place 'pAudioIO->FragmentSize << CONFIG_MAX_PITCH'
157	// number of '0' samples (silence samples) behind the official buffer
158	// border, to allow the interpolator do it's work even at the end of
159	// the sample.
160	const uint maxSamplesPerCycle =
161	(pEngineChannel->GetEngine()) ? dynamic_cast<gig::Engine*>(pEngineChannel->GetEngine())->pAudioOutputDevice->MaxSamplesPerCycle()
162	: GIG_RESOURCE_MANAGER_DEFAULT_MAX_SAMPLES_PER_CYCLE;
163	const uint neededSilenceSamples = (maxSamplesPerCycle << CONFIG_MAX_PITCH) + 3;
164	const uint currentlyCachedSilenceSamples = pSample->GetCache().NullExtensionSize / pSample->FrameSize;
165	if (currentlyCachedSilenceSamples < neededSilenceSamples) {
166	dmsg(3,("Caching whole sample (sample name: \"%s\", sample size: %d)\n", pSample->pInfo->Name.c_str(), pSample->SamplesTotal));
167	::gig::buffer_t buf = pSample->LoadSampleDataWithNullSamplesExtension(neededSilenceSamples);
168	dmsg(4,("Cached %d Bytes, %d silence bytes.\n", buf.Size, buf.NullExtensionSize));
169	}
170	}
171	else { // we only cache CONFIG_PRELOAD_SAMPLES and stream the other sample points from disk
172	if (!pSample->GetCache().Size) pSample->LoadSampleData(CONFIG_PRELOAD_SAMPLES);
173	}
174
175	if (!pSample->GetCache().Size) std::cerr << "Unable to cache sample - maybe memory full!" << std::endl << std::flush;
176	}
177
178
179
180	// internal gig file manager
181
182	::gig::File* InstrumentResourceManager::GigResourceManager::Create(String Key, GigConsumer* pConsumer, void*& pArg) {
183	dmsg(1,("Loading gig file \'%s\'...", Key.c_str()));
184	::RIFF::File* pRIFF = new ::RIFF::File(Key);
185	::gig::File* pGig = new ::gig::File(pRIFF);
186	pArg = pRIFF;
187	dmsg(1,("OK\n"));
188	return pGig;
189	}
190
191	void InstrumentResourceManager::GigResourceManager::Destroy(::gig::File* pResource, void* pArg) {
192	dmsg(1,("Freeing gig file from memory..."));
193	delete pResource;
194	delete (::RIFF::File*) pArg;
195	dmsg(1,("OK\n"));
196	}
197
198	}} // namespace LinuxSampler::gig