Developer Docs: Rotate Transformation

Rotate transformation allows users to change the orientation of an image by a certain angle.

It helps to rotate the output image by an angle. When rotating by an angle other than a multiple of 90, the background color can be provided with the background option.

Params

Angle (`a`)

The angle of rotation.

Background (`b`)

The background color when the angle of rotation is not a multiple of 90. Uses a hex value to determine the background color.

Original Image
angle=90
angle=350, background=17181d

https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/original/images/transformation/seaplane.jpg?v=1763640455765

<PixelBinImage
    url="https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/original/images/transformation/seaplane.jpg?v=1763640455765"
/>

import Pixelbin from "@pixelbin/core";

const obj = {
    cloudName: "dummy-cloudname",
    zone: "FIDrmb",
    version: "v2",
    transformations: [],
    filePath: "images/transformation/seaplane.jpg",
    baseUrl: "https://cdn.pixelbin.io",
};

const url = Pixelbin.default.utils.objToUrl(obj);

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/original/images/transformation/seaplane.jpg?v=1763640455765

const Pixelbin = require("@pixelbin/admin");

const obj = {
    cloudName: "dummy-cloudname",
    zone: "FIDrmb",
    version: "v2",
    transformations: [],
    filePath: "images/transformation/seaplane.jpg",
    baseUrl: "https://cdn.pixelbin.io",
};

const url = Pixelbin.url.objToUrl(obj);

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/original/images/transformation/seaplane.jpg?v=1763640455765

from pixelbin.utils.url import obj_to_url

obj = {
    "cloudName": "dummy-cloudname",
    "zone": "FIDrmb",
    "version": "v2",
    "transformations": [],
    "filePath": "images/transformation/seaplane.jpg",
    "baseUrl": "https://cdn.pixelbin.io",
}

url = obj_to_url(obj)

# url
# https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/original/images/transformation/seaplane.jpg?v=1763640455765

package main

import (
 "fmt"
 "github.com/pixelbin-dev/pixelbin-go/v2/sdk/utils/url"
)

func main() {
    obj := map[string]interface{}{
        "cloudName": "dummy-cloudname",
        "zoneSlug": "FIDrmb",
        "version": "v2",
        "transformations": []map[string]interface{}{
            
        },
        "filePath": "images/transformation/seaplane.jpg",
        "baseUrl": "https://cdn.pixelbin.io",
        "options": map[string]interface{}{},
    }

    urlstring, err := url.ObjToUrl(obj)

    if err != nil {
        fmt.Println(err)
    }
}

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/original/images/transformation/seaplane.jpg?v=1763640455765

import com.pixelbin.url.UrlObj
import com.pixelbin.Utils
import com.pixelbin.transformation.TransformationObj

fun main(){
    val obj = UrlObj(
        cloudName = "dummy-cloudname",
        zone = "FIDrmb",
        version = "v2",
        transformation = arrayListOf(
            
        ),
        filePath = "images/transformation/seaplane.jpg",
        baseUrl = "https://cdn.pixelbin.io"
    )

    val url = Utils.objToUrl(obj)
}

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/original/images/transformation/seaplane.jpg?v=1763640455765

using System;
using System.Collections.Generic;
using System.IO;
using Pixelbin.Utils;

namespace ExampleNamespace
{
    class ExampleClass
    {
        static void Main(string[] args)
        {
            UrlObj obj = new UrlObj(
                version: "v2",
                cloudName: "dummy-cloudname",
                filePath: "images/transformation/seaplane.jpg",
                zone: "FIDrmb",
                baseUrl: "https://cdn.pixelbin.io",
                transformations: new List<UrlTransformation>() {
                    
                }
            );

            string url = Url.ObjToUrl(obj);
        }
    }
}

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/original/images/transformation/seaplane.jpg?v=1763640455765

<?php
require 'vendor/autoload.php';
use Pixelbin\Utils\Url;

$obj = [
    "cloudName" => "dummy-cloudname",
    "zone" => "FIDrmb",
    "version" => "v2",
    "options" => [],
    "transformations" => [
        
    ],
    "filePath" => "images/transformation/seaplane.jpg",
    "baseUrl" => "https://cdn.pixelbin.io",
];

$url = Url::obj_to_url($obj);

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/original/images/transformation/seaplane.jpg?v=1763640455765
?>

The image has been rotated at 90 degrees.

https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/t.rotate(a:90)/images/transformation/seaplane.jpg?v=1763640455765

<PixelBinImage
    url="https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/t.rotate(a:90)/images/transformation/seaplane.jpg?v=1763640455765"
/>

import Pixelbin from "@pixelbin/core";

const obj = {
    cloudName: "dummy-cloudname",
    zone: "FIDrmb",
    version: "v2",
    transformations: [{"name":"rotate","plugin":"t","values":[{"key":"a","value":"90"}]}],
    filePath: "images/transformation/seaplane.jpg",
    baseUrl: "https://cdn.pixelbin.io",
};

const url = Pixelbin.default.utils.objToUrl(obj);

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/t.rotate(a:90)/images/transformation/seaplane.jpg?v=1763640455765

const Pixelbin = require("@pixelbin/admin");

const obj = {
    cloudName: "dummy-cloudname",
    zone: "FIDrmb",
    version: "v2",
    transformations: [{"name":"rotate","plugin":"t","values":[{"key":"a","value":"90"}]}],
    filePath: "images/transformation/seaplane.jpg",
    baseUrl: "https://cdn.pixelbin.io",
};

const url = Pixelbin.url.objToUrl(obj);

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/t.rotate(a:90)/images/transformation/seaplane.jpg?v=1763640455765

from pixelbin.utils.url import obj_to_url

obj = {
    "cloudName": "dummy-cloudname",
    "zone": "FIDrmb",
    "version": "v2",
    "transformations": [{"name":"rotate","plugin":"t","values":[{"key":"a","value":"90"}]}],
    "filePath": "images/transformation/seaplane.jpg",
    "baseUrl": "https://cdn.pixelbin.io",
}

url = obj_to_url(obj)

# url
# https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/t.rotate(a:90)/images/transformation/seaplane.jpg?v=1763640455765

package main

import (
 "fmt"
 "github.com/pixelbin-dev/pixelbin-go/v2/sdk/utils/url"
)

func main() {
    obj := map[string]interface{}{
        "cloudName": "dummy-cloudname",
        "zoneSlug": "FIDrmb",
        "version": "v2",
        "transformations": []map[string]interface{}{
            {"plugin": "t", "name": "rotate", "values": []map[string]interface{}{ {"key": "a", "value": "90"},}},
        },
        "filePath": "images/transformation/seaplane.jpg",
        "baseUrl": "https://cdn.pixelbin.io",
        "options": map[string]interface{}{},
    }

    urlstring, err := url.ObjToUrl(obj)

    if err != nil {
        fmt.Println(err)
    }
}

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/t.rotate(a:90)/images/transformation/seaplane.jpg?v=1763640455765

import com.pixelbin.url.UrlObj
import com.pixelbin.Utils
import com.pixelbin.transformation.TransformationObj

fun main(){
    val obj = UrlObj(
        cloudName = "dummy-cloudname",
        zone = "FIDrmb",
        version = "v2",
        transformation = arrayListOf(
            TransformationObj( plugin = "t", name = "rotate", values = hashMapOf( "a" to "90"), )
        ),
        filePath = "images/transformation/seaplane.jpg",
        baseUrl = "https://cdn.pixelbin.io"
    )

    val url = Utils.objToUrl(obj)
}

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/t.rotate(a:90)/images/transformation/seaplane.jpg?v=1763640455765

using System;
using System.Collections.Generic;
using System.IO;
using Pixelbin.Utils;

namespace ExampleNamespace
{
    class ExampleClass
    {
        static void Main(string[] args)
        {
            UrlObj obj = new UrlObj(
                version: "v2",
                cloudName: "dummy-cloudname",
                filePath: "images/transformation/seaplane.jpg",
                zone: "FIDrmb",
                baseUrl: "https://cdn.pixelbin.io",
                transformations: new List<UrlTransformation>() {
                    new UrlTransformation(plugin: "t", name: "rotate", values: new List<Dictionary<string, string>>() { new Dictionary<string, string>() { { "key", "a" }, { "value", "90" } }} )
                }
            );

            string url = Url.ObjToUrl(obj);
        }
    }
}

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/t.rotate(a:90)/images/transformation/seaplane.jpg?v=1763640455765

<?php
require 'vendor/autoload.php';
use Pixelbin\Utils\Url;

$obj = [
    "cloudName" => "dummy-cloudname",
    "zone" => "FIDrmb",
    "version" => "v2",
    "options" => [],
    "transformations" => [
        ["plugin" => "t", "name" => "rotate", "values" => [ [ "key" => "a", "value" => "90" ], ], ],
    ],
    "filePath" => "images/transformation/seaplane.jpg",
    "baseUrl" => "https://cdn.pixelbin.io",
];

$url = Url::obj_to_url($obj);

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/t.rotate(a:90)/images/transformation/seaplane.jpg?v=1763640455765
?>

The angle was reset to 350 degrees with a background color.

https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/t.rotate(a:350,b:17181d)/images/transformation/seaplane.jpg?v=1763640455765

<PixelBinImage
    url="https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/t.rotate(a:350,b:17181d)/images/transformation/seaplane.jpg?v=1763640455765"
/>

import Pixelbin from "@pixelbin/core";

const obj = {
    cloudName: "dummy-cloudname",
    zone: "FIDrmb",
    version: "v2",
    transformations: [{"name":"rotate","plugin":"t","values":[{"key":"a","value":"350"},{"key":"b","value":"17181d"}]}],
    filePath: "images/transformation/seaplane.jpg",
    baseUrl: "https://cdn.pixelbin.io",
};

const url = Pixelbin.default.utils.objToUrl(obj);

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/t.rotate(a:350,b:17181d)/images/transformation/seaplane.jpg?v=1763640455765

const Pixelbin = require("@pixelbin/admin");

const obj = {
    cloudName: "dummy-cloudname",
    zone: "FIDrmb",
    version: "v2",
    transformations: [{"name":"rotate","plugin":"t","values":[{"key":"a","value":"350"},{"key":"b","value":"17181d"}]}],
    filePath: "images/transformation/seaplane.jpg",
    baseUrl: "https://cdn.pixelbin.io",
};

const url = Pixelbin.url.objToUrl(obj);

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/t.rotate(a:350,b:17181d)/images/transformation/seaplane.jpg?v=1763640455765

from pixelbin.utils.url import obj_to_url

obj = {
    "cloudName": "dummy-cloudname",
    "zone": "FIDrmb",
    "version": "v2",
    "transformations": [{"name":"rotate","plugin":"t","values":[{"key":"a","value":"350"},{"key":"b","value":"17181d"}]}],
    "filePath": "images/transformation/seaplane.jpg",
    "baseUrl": "https://cdn.pixelbin.io",
}

url = obj_to_url(obj)

# url
# https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/t.rotate(a:350,b:17181d)/images/transformation/seaplane.jpg?v=1763640455765

package main

import (
 "fmt"
 "github.com/pixelbin-dev/pixelbin-go/v2/sdk/utils/url"
)

func main() {
    obj := map[string]interface{}{
        "cloudName": "dummy-cloudname",
        "zoneSlug": "FIDrmb",
        "version": "v2",
        "transformations": []map[string]interface{}{
            {"plugin": "t", "name": "rotate", "values": []map[string]interface{}{ {"key": "a", "value": "350"},{"key": "b", "value": "17181d"},}},
        },
        "filePath": "images/transformation/seaplane.jpg",
        "baseUrl": "https://cdn.pixelbin.io",
        "options": map[string]interface{}{},
    }

    urlstring, err := url.ObjToUrl(obj)

    if err != nil {
        fmt.Println(err)
    }
}

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/t.rotate(a:350,b:17181d)/images/transformation/seaplane.jpg?v=1763640455765

import com.pixelbin.url.UrlObj
import com.pixelbin.Utils
import com.pixelbin.transformation.TransformationObj

fun main(){
    val obj = UrlObj(
        cloudName = "dummy-cloudname",
        zone = "FIDrmb",
        version = "v2",
        transformation = arrayListOf(
            TransformationObj( plugin = "t", name = "rotate", values = hashMapOf( "a" to "350","b" to "17181d"), )
        ),
        filePath = "images/transformation/seaplane.jpg",
        baseUrl = "https://cdn.pixelbin.io"
    )

    val url = Utils.objToUrl(obj)
}

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/t.rotate(a:350,b:17181d)/images/transformation/seaplane.jpg?v=1763640455765

using System;
using System.Collections.Generic;
using System.IO;
using Pixelbin.Utils;

namespace ExampleNamespace
{
    class ExampleClass
    {
        static void Main(string[] args)
        {
            UrlObj obj = new UrlObj(
                version: "v2",
                cloudName: "dummy-cloudname",
                filePath: "images/transformation/seaplane.jpg",
                zone: "FIDrmb",
                baseUrl: "https://cdn.pixelbin.io",
                transformations: new List<UrlTransformation>() {
                    new UrlTransformation(plugin: "t", name: "rotate", values: new List<Dictionary<string, string>>() { new Dictionary<string, string>() { { "key", "a" }, { "value", "350" } }, new Dictionary<string, string>() { { "key", "b" }, { "value", "17181d" } }} )
                }
            );

            string url = Url.ObjToUrl(obj);
        }
    }
}

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/t.rotate(a:350,b:17181d)/images/transformation/seaplane.jpg?v=1763640455765

<?php
require 'vendor/autoload.php';
use Pixelbin\Utils\Url;

$obj = [
    "cloudName" => "dummy-cloudname",
    "zone" => "FIDrmb",
    "version" => "v2",
    "options" => [],
    "transformations" => [
        ["plugin" => "t", "name" => "rotate", "values" => [ [ "key" => "a", "value" => "350" ], [ "key" => "b", "value" => "17181d" ], ], ],
    ],
    "filePath" => "images/transformation/seaplane.jpg",
    "baseUrl" => "https://cdn.pixelbin.io",
];

$url = Url::obj_to_url($obj);

// url
// https://cdn.pixelbin.io/v2/dummy-cloudname/FIDrmb/t.rotate(a:350,b:17181d)/images/transformation/seaplane.jpg?v=1763640455765
?>

Developer Docs: Rotate Transformation

Params

Angle (a)

Background (b)

Angle (`a`)

Background (`b`)