using UnityEngine;
using System.Collections.Generic;
using MLAgents.InferenceBrain;
namespace MLAgents
{
public static class Utilities
{
///
/// Converts a list of Texture2D into a TensorProxy.
///
///
/// The list of textures to be put into the tensor.
/// Note that the textures must have same width and height.
///
///
/// TensorProxy to fill with Texture data.
///
///
/// If set to true the textures will be converted to grayscale before
/// being stored in the tensor.
///
public static void TextureToTensorProxy(
List textures,
TensorProxy tensorProxy,
bool grayScale)
{
var numTextures = textures.Count;
var width = textures[0].width;
var height = textures[0].height;
for (var t = 0; t < numTextures; t++)
{
var texture = textures[t];
Debug.Assert(width == texture.width, "All Textures must have the same dimension");
Debug.Assert(height == texture.height, "All Textures must have the same dimension");
TextureToTensorProxy(texture, tensorProxy, grayScale, t);
}
}
///
/// Puts a Texture2D into a TensorProxy.
///
///
/// The texture to be put into the tensor.
///
///
/// TensorProxy to fill with Texture data.
///
///
/// If set to true the textures will be converted to grayscale before
/// being stored in the tensor.
///
///
/// Index of the texture being written.
///
public static void TextureToTensorProxy(
Texture2D texture,
TensorProxy tensorProxy,
bool grayScale,
int textureOffset = 0)
{
var width = texture.width;
var height = texture.height;
var data = tensorProxy.data;
var t = textureOffset;
var texturePixels = texture.GetPixels32();
for (var h = height - 1; h >= 0; h--)
{
for (var w = 0; w < width; w++)
{
var currentPixel = texturePixels[(height - h - 1) * width + w];
if (grayScale)
{
data[t, h, w, 0] =
(currentPixel.r + currentPixel.g + currentPixel.b) / 3f / 255.0f;
}
else
{
// For Color32, the r, g and b values are between 0 and 255.
data[t, h, w, 0] = currentPixel.r / 255.0f;
data[t, h, w, 1] = currentPixel.g / 255.0f;
data[t, h, w, 2] = currentPixel.b / 255.0f;
}
}
}
}
///
/// Calculates the cumulative sum of an integer array. The result array will be one element
/// larger than the input array since it has a padded 0 at the beginning.
/// If the input is [a, b, c], the result will be [0, a, a+b, a+b+c]
///
///
/// Input array whose elements will be cumulatively added
///
/// The cumulative sum of the input array.
public static int[] CumSum(int[] input)
{
var runningSum = 0;
var result = new int[input.Length + 1];
for (var actionIndex = 0; actionIndex < input.Length; actionIndex++)
{
runningSum += input[actionIndex];
result[actionIndex + 1] = runningSum;
}
return result;
}
///
/// Shifts list elements to the left by the specified amount (in-place).
///
/// List whose elements will be shifted
///
///
/// Amount to shift the elements to the left by
///
///
public static void ShiftLeft(List list, int shiftAmount)
{
for (var i = shiftAmount; i < list.Count; i++)
{
list[i - shiftAmount] = list[i];
}
}
///
/// Replaces target list elements with source list elements starting at specified position
/// in target list.
///
/// Target list, where the elements are added to
///
///
/// Source array, where the elements are copied from
///
///
/// Starting position in target list to copy elements to
///
///
public static void ReplaceRange(List dst, List src, int start)
{
for (var i = 0; i < src.Count; i++)
{
dst[i + start] = src[i];
}
}
///
/// Adds elements to list without extra temp allocations (assuming it fits pre-allocated
/// capacity of the list). The built-in List/.AddRange() unfortunately allocates
/// a temporary list to add items (even if the original array has sufficient capacity):
/// https://stackoverflow.com/questions/2123161/listt-addrange-implementation-suboptimal
/// Note: this implementation might be slow with a large source array.
///
/// Target list, where the elements are added to
///
///
/// Source array, where the elements are copied from
///
///
// ReSharper disable once ParameterTypeCanBeEnumerable.Global
public static void AddRangeNoAlloc(List dst, T[] src)
{
// ReSharper disable once LoopCanBeConvertedToQuery
foreach (var item in src)
{
dst.Add(item);
}
}
}
}