add documentation to calculateSpawnPosition

include/AssetManager.h

@@ -27,8 +27,14 @@ public:
     void createProjectile(Vector2D pos, Vector2D velocity, int scale, int range, int speed, const char* texturePath, Entity* owner);
     void createPowerup(Vector2D pos, std::function<void (Entity*)> pickupFunc, std::string texturePath);
 
-    Vector2D calculateSpawnPosition(int width, int height);
+    /*!
-    template <typename T> T calculateType(int amount);
+	 * \brief Calculates a random spawn position for an object within a given area
+     * \param size The size (collision box) of the object
+     * \param spawnArea The area within which a spawn position will be calculated
+	 * \returns Spawn Coordinates for the object
+     */
+    Vector2D calculateSpawnPosition(Vector2D size, Vector2D spawnArea);
+    template <typename T> [[deprecated]] T calculateRandomType(int amount);
 
     //texture management
     void addTexture(std::string id, const char* path);

src/AssetManager.cpp

@@ -74,17 +74,19 @@ void AssetManager::createPowerup(Vector2D pos, std::function<void (Entity*)> pic
     powerups.addGroup((size_t)Entity::GroupLabel::POWERUPS);
 }
 
-Vector2D AssetManager::calculateSpawnPosition(int width, int height)
+
+Vector2D AssetManager::calculateSpawnPosition(Vector2D size, Vector2D spawnArea)
 {
     Vector2D spawnPos = Vector2D(-1, -1);
 
     for(int i = 0; i <= SPAWN_ATTEMPTS; i++)
     {
+
         SDL_Rect spawnRect = {
-                rand() % (SCREEN_SIZE_WIDTH - width),
+                rand() % (int)(spawnArea.x - size.x),
-                rand() % (SCREEN_SIZE_HEIGHT - height),
+                rand() % (int)(spawnArea.y - size.y),
-                width,
+                size.x,
-                height
+                size.y
         };
 
         std::vector<ColliderComponent*> colliders = this->man->getGame()->collisionHandler->getColliders({Entity::GroupLabel::MAPTILES});
@@ -103,7 +105,7 @@ Vector2D AssetManager::calculateSpawnPosition(int width, int height)
 }
 
 template <typename T>
-T AssetManager::calculateType(int amount)
+T AssetManager::calculateRandomType(int amount)
 {
     T type = T(rand() % amount);
     return type;