Addressed some criticism

getRecordingDevices internal function is now returns constant reference,
also re-enumerates devices every time it is called; this is a slow operation
getID removed for not being useful

--HG--
branch : minor-mic-input

src/modules/audio/Audio.h

@@ -192,7 +192,7 @@ public:
 	/**
 	 * @return Reference to a vector of pointers to recording devices. May be empty.
 	 **/
-	virtual std::vector<RecordingDevice*> *getRecordingDevices() = 0;
+	virtual const std::vector<RecordingDevice*> &getRecordingDevices() = 0;
 
 	/**
 	 * Gets the distance model used for attenuation.

src/modules/audio/RecordingDevice.h

@@ -69,11 +69,6 @@ public:
 	 **/ 
 	virtual const char *getName() const = 0;
 
-	/**
-	 * @return Unique ID number.
-	 **/ 
-	virtual int getID() const = 0;
-
 	/**
 	 * @return Number of samples currently recorded.
 	 **/

src/modules/audio/null/Audio.cpp

@@ -144,9 +144,9 @@ float Audio::getDopplerScale() const
 	return 1.0f;
 }
 
-std::vector<love::audio::RecordingDevice*> *Audio::getRecordingDevices()
+const std::vector<love::audio::RecordingDevice*> &Audio::getRecordingDevices()
 {
-	return &capture;
+	return capture;
 }
 
 Audio::DistanceModel Audio::getDistanceModel() const

src/modules/audio/null/Audio.h

@@ -71,7 +71,7 @@ public:
 	void setDopplerScale(float scale);
 	float getDopplerScale() const;
 
-	std::vector<love::audio::RecordingDevice*> *getRecordingDevices();
+	const std::vector<love::audio::RecordingDevice*> &getRecordingDevices();
 
 	DistanceModel getDistanceModel() const;
 	void setDistanceModel(DistanceModel distanceModel);

src/modules/audio/null/RecordingDevice.cpp

@@ -82,11 +82,6 @@ const char *RecordingDevice::getName() const
 	return name;
 }
 
-int RecordingDevice::getID() const
-{
-	return 0;
-}
-
 bool RecordingDevice::isRecording() const
 {
 	return false;

src/modules/audio/null/RecordingDevice.h

@@ -41,7 +41,6 @@ public:
 	virtual void stopRecording();
 	virtual love::sound::SoundData *getData();
 	virtual const char *getName() const;
-	virtual int getID() const;
 	virtual int getSampleCount() const;
 	virtual int getSampleRate() const;
 	virtual int getBitDepth() const;

src/modules/audio/openal/Audio.cpp

@@ -313,10 +313,10 @@ void Audio::setDistanceModel(DistanceModel distanceModel)
 	}
 }
 
-std::vector<love::audio::RecordingDevice*> *Audio::getRecordingDevices()
+const std::vector<love::audio::RecordingDevice*> &Audio::getRecordingDevices()
-{
-	if (capture.size() == 0)
 {
+	capture.clear();
+
 	std::string defaultname(alcGetString(NULL, ALC_CAPTURE_DEFAULT_DEVICE_SPECIFIER));
 
 	//no device name obtained from AL, fallback to reading from device
@@ -331,7 +331,7 @@ std::vector<love::audio::RecordingDevice*> *Audio::getRecordingDevices()
 		}
 		else
 		//failed to open default recording device - bail, return empty list
-				return &capture;
+			return capture;
 	}
 	capture.push_back(new RecordingDevice(defaultname.c_str(), 0));
 
@@ -346,8 +346,8 @@ std::vector<love::audio::RecordingDevice*> *Audio::getRecordingDevices()
 			capture.push_back(new RecordingDevice(str.c_str(), capture.size()));
 		offset += str.length() + 1;
 	}
-	}
+
-	return &capture;
+	return capture;
 }
 
 } // openal

src/modules/audio/openal/Audio.h

@@ -105,7 +105,7 @@ public:
 	void setDopplerScale(float scale);
 	float getDopplerScale() const;
 
-	std::vector<love::audio::RecordingDevice*> *getRecordingDevices();
+	const std::vector<love::audio::RecordingDevice*> &getRecordingDevices();
 
 	DistanceModel getDistanceModel() const;
 	void setDistanceModel(DistanceModel distanceModel);

src/modules/audio/openal/RecordingDevice.cpp

@@ -148,11 +148,6 @@ const char *RecordingDevice::getName() const
 	return name.c_str();
 }
 
-int RecordingDevice::getID() const
-{
-	return id;
-}
-
 bool RecordingDevice::isRecording() const
 {
 	return device != nullptr;

src/modules/audio/openal/RecordingDevice.h

@@ -54,7 +54,6 @@ public:
 	virtual void stopRecording();
 	virtual love::sound::SoundData *getData();
 	virtual const char *getName() const;
-	virtual int getID() const;
 	virtual int getSampleCount() const;
 	virtual int getSampleRate() const;
 	virtual int getBitDepth() const;

src/modules/audio/wrap_Audio.cpp

@@ -279,13 +279,13 @@ int w_getDistanceModel(lua_State *L)
 
 int w_getRecordingDevices(lua_State *L)
 {
-	std::vector<RecordingDevice*> *devices = instance()->getRecordingDevices();
+	const std::vector<RecordingDevice*> &devices = instance()->getRecordingDevices();
 
-	lua_createtable(L, (*devices).size(), 0);
+	lua_createtable(L, devices.size(), 0);
 
-	for (unsigned int i = 0; i < (*devices).size(); i++)
+	for (unsigned int i = 0; i < devices.size(); i++)
 	{
-		luax_pushtype(L, AUDIO_RECORDING_DEVICE_ID, (*devices)[i]);
+		luax_pushtype(L, AUDIO_RECORDING_DEVICE_ID, devices[i]);
 		lua_rawseti(L, -2, i + 1);
 	}
 

src/modules/audio/wrap_RecordingDevice.cpp

@@ -128,13 +128,6 @@ int w_RecordingDevice_getName(lua_State *L)
 	return 1;
 }
 
-int w_RecordingDevice_getID(lua_State *L)
-{
-	RecordingDevice *d = luax_checkrecordingdevice(L, 1);
-	lua_pushnumber(L, d->getID());
-	return 1;
-}
-
 int w_RecordingDevice_isRecording(lua_State *L)
 {
 	RecordingDevice *d = luax_checkrecordingdevice(L, 1);
@@ -152,7 +145,6 @@ static const luaL_Reg w_RecordingDevice_functions[] =
 	{ "getBitDepth", w_RecordingDevice_getBitDepth },
 	{ "getChannels", w_RecordingDevice_getChannels },
 	{ "getName", w_RecordingDevice_getName },
-	{ "getID", w_RecordingDevice_getID },
 	{ "isRecording", w_RecordingDevice_isRecording },
 	{ 0, 0 }
 };