/// <summary>
/// This method can be used to force refresh facebook and twitter profile pictures. The response of this method includes the image's version. Use this version to bypass previously cached CDN copies.
/// Also it can be used to generate transformed versions of an uploaded image. This is useful when Strict Transformations are allowed for your account and you wish to create custom derived images for already uploaded images.
/// </summary>
/// <param name="parameters">The parameters.</param>
/// <returns></returns>
public ExplicitResult Explicit(ExplicitParams parameters)
{
string uri = m_api.ApiUrlImgUpV.Action("explicit").BuildUrl();
using (HttpWebResponse response = m_api.Call(HttpMethod.POST, uri, parameters.ToParamsDictionary(), null))
{
return ExplicitResult.Parse(response);
}
}
public void TestFaceCoordinates()
{
//should allow sending face coordinates
var faceCoordinates = new List<Rectangle>()
{
new Rectangle(121,31,110,151),
new Rectangle(120,30,109,150)
};
var uploadParams = new ImageUploadParams()
{
File = new FileDescription(m_testImagePath),
FaceCoordinates = faceCoordinates,
Faces = true
};
var uploadRes = m_cloudinary.Upload(uploadParams);
Assert.NotNull(uploadRes.Faces);
Assert.AreEqual(2, uploadRes.Faces.Length);
Assert.AreEqual(4, uploadRes.Faces[0].Length);
for (int i = 0; i < 2; i++)
{
Assert.AreEqual(faceCoordinates[i].X, uploadRes.Faces[i][0]);
Assert.AreEqual(faceCoordinates[i].Y, uploadRes.Faces[i][1]);
Assert.AreEqual(faceCoordinates[i].Width, uploadRes.Faces[i][2]);
Assert.AreEqual(faceCoordinates[i].Height, uploadRes.Faces[i][3]);
}
var explicitParams = new ExplicitParams(uploadRes.PublicId)
{
FaceCoordinates = "122,32,111,152",
Type = "upload"
};
var explicitRes = m_cloudinary.Explicit(explicitParams);
var res = m_cloudinary.GetResource(
new GetResourceParams(uploadRes.PublicId) { Faces = true });
Assert.NotNull(res.Faces);
Assert.AreEqual(1, res.Faces.Length);
Assert.AreEqual(4, res.Faces[0].Length);
Assert.AreEqual(122, res.Faces[0][0]);
Assert.AreEqual(32, res.Faces[0][1]);
Assert.AreEqual(111, res.Faces[0][2]);
Assert.AreEqual(152, res.Faces[0][3]);
}
public void TestJsonObject()
{
ExplicitParams exp = new ExplicitParams("cloudinary")
{
EagerTransforms = new List<Transformation>() {
new EagerTransformation().Crop("scale").Width(2.0) },
Type = "twitter_name"
};
var result = m_cloudinary.Explicit(exp);
Assert.NotNull(result.JsonObj);
Assert.AreEqual(result.PublicId, result.JsonObj["public_id"].ToString());
}
public void TestExplicitContext()
{
var exp = new ExplicitParams("cloudinary")
{
EagerTransforms = new List<Transformation>() { new Transformation().Crop("scale").Width(2.0) },
Type = "twitter_name",
Context = new StringDictionary("context1=254")
};
var expResult = m_cloudinary.Explicit(exp);
Assert.IsNotNull(expResult);
var getResult = m_cloudinary.GetResource(new GetResourceParams(expResult.PublicId) { Type = "twitter_name" });
Assert.IsNotNull(getResult);
Assert.AreEqual("254", getResult.Context["custom"]["context1"].ToString());
}
public void TestExplicit()
{
ExplicitParams exp = new ExplicitParams("cloudinary")
{
EagerTransforms = new List<Transformation>() { new Transformation().Crop("scale").Width(2.0) },
Type = "twitter_name"
};
ExplicitResult expResult = m_cloudinary.Explicit(exp);
string url = new Url(m_account.Cloud).ResourceType("image").Add("twitter_name").
Transform(new Transformation().Crop("scale").Width(2.0)).
Format("png").Version(expResult.Version).BuildUrl("cloudinary");
Assert.AreEqual(url, expResult.Eager[0].Uri.AbsoluteUri);
}
public void TestExplicitInvalidate()
{
ExplicitParams exp = new ExplicitParams("cloudinary")
{
EagerTransforms = new List<Transformation>() { new Transformation().Crop("scale").Width(2.0) },
Invalidate = true,
Type = "twitter_name"
};
string rString = GetMockBodyOfCoudinaryRequest(exp, (p, t) => { return p.Explicit(t); });
StringAssert.Contains("name=\"invalidate\"\r\n\r\ntrue\r\n", rString);
}
public void TestResponsiveBreakpoints()
{
var breakpoint = new ResponsiveBreakpoint().MaxImages(5).BytesStep(20)
.MinWidth(200).MaxWidth(1000).CreateDerived(false);
var breakpoint2 = new ResponsiveBreakpoint().Transformation(new Transformation().Width(0.9).Crop("scale").Radius(50)).MaxImages(4).BytesStep(20)
.MinWidth(100).MaxWidth(900).CreateDerived(false);
// An array of breakpoints
ImageUploadParams uploadParams = new ImageUploadParams()
{
File = new FileDescription(m_testImagePath),
PublicId = "responsiveBreakpoint_id",
Tags = "test",
ResponsiveBreakpoints = new List<ResponsiveBreakpoint> { breakpoint, breakpoint2 }
};
ImageUploadResult result = m_cloudinary.Upload(uploadParams);
Assert.Null(result.Error);
Assert.NotNull(result.ResponsiveBreakpoints, "result should include 'ResponsiveBreakpoints'");
Assert.AreEqual(2, result.ResponsiveBreakpoints.Count);
Assert.AreEqual(5, result.ResponsiveBreakpoints[0].Breakpoints.Count);
Assert.AreEqual(1000, result.ResponsiveBreakpoints[0].Breakpoints[0].Width);
Assert.AreEqual(200, result.ResponsiveBreakpoints[0].Breakpoints[4].Width);
Assert.AreEqual(4, result.ResponsiveBreakpoints[1].Breakpoints.Count);
Assert.AreEqual(900, result.ResponsiveBreakpoints[1].Breakpoints[0].Width);
Assert.AreEqual(100, result.ResponsiveBreakpoints[1].Breakpoints[3].Width);
// responsive breakpoints for Explicit()
ExplicitParams exp = new ExplicitParams("responsiveBreakpoint_id")
{
EagerTransforms = new List<Transformation>() { new Transformation().Crop("scale").Width(2.0) },
Type = "upload",
ResponsiveBreakpoints = new List<ResponsiveBreakpoint> { breakpoint2.CreateDerived(true) }
};
ExplicitResult expResult = m_cloudinary.Explicit(exp);
Assert.AreEqual(1, expResult.ResponsiveBreakpoints.Count);
Assert.AreEqual(4, expResult.ResponsiveBreakpoints[0].Breakpoints.Count);
Assert.AreEqual(900, expResult.ResponsiveBreakpoints[0].Breakpoints[0].Width);
Assert.AreEqual(100, expResult.ResponsiveBreakpoints[0].Breakpoints[3].Width);
}