Photomatix API Documentation (Beta)

# Replace with your API key
APIKEY="YOUR_API_KEY"

engineLocation="$(curl -i -X POST -H "x-pm-token: $APIKEY" "https://hdr-photography.com:8081/hdrengines?type=multi&alignment=yes&deghosting=off&noise-reduction=none&output-bit-depth=8" | grep Location: | sed 's/\r//' | awk '{ print $2 }')"
if [ "$engineLocation" = "" ]; then
  echo "HDR Engine creation failed"
  exit 1
fi
  

<?php
//Replace with your API key
$apiKey = "YOUR_API_KEY";

function getLocation($response) {
  $headerLines = explode("\r\n", $response);
  foreach ($headerLines as $line)
    if (strpos($line, 'Location:') !== false)
      return trim(str_replace('Location:', '', $line));
  return "";
}   

function getJsonResponse($curl, $response) {
  if ($response === false) return null;
  $headerSize = curl_getinfo($curl, CURLINFO_HEADER_SIZE);
  $body = substr($response, $headerSize);
  return json_decode($body, true);
}   

$curl = curl_init("https://hdr-photography.com:8081/hdrengines?type=multi");
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, array("x-pm-token: " . $apiKey));
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_HEADER, true);

$response = curl_exec($curl);
$jsonResponse = getJsonResponse($curl, $response);

if ($response === false)
    die("Curl error: " . curl_error($curl));
curl_close($curl);

$engineLocation = getLocation($response);
if ($engineLocation == "") {
    $error = "Couldn't create HDR engine";
    if (isset($jsonResponse['error']['message']))
        $error .= ": " . $jsonResponse['error']['message'];
    die($error);
}

?>

# Note: This code snippet should appear below the code for step 1, in the same script

# Replace with your API key
APIKEY="YOUR_API_KEY"

# Replace with the path to the folder where your bracketed images are
imageSourceDir="/path/to/image/dir"

for image in "$imageSourceDir"/*; do
  if [ -f "$image" ]; thenurls=('https://www.hdrsoft.com/samples/img1.jpg' 'https://www.hdrsoft.com/samples/img2.jpg' 'https://www.hdrsoft.com/samples/img3.jpg')
for image in "${urls[@]}"; do
    baseName="$(basename "$image")"
    # The $engineLocation variable was set in step 1
    curl -i -X "POST" -H "x-pm-token: $APIKEY" "https://hdr-photography.com:8081$engineLocation/images/$baseName"  -F "image=@$image""url=$image"
  fi
done
  

<?php

//Note: This code snippet should appear below the code for step 1, in the same script

//Replace with your API key
$apiKey = "YOUR_API_KEY";

 // Replace with the path to the folder where your bracketed images are
$imageSourceDir = "/path/to/image/dir";

// The $engineLocation variable that was set in step 1
$baseURL = rtrim($engineLocation, '/');

$imagesToProcess = scandir($imageSourceDir);

// Loop through each file in the folder
// All images in the folder will be loaded and merged - Adjust the loop if you want to merge one set of files at a time$imagesToProcess = array('https://www.hdrsoft.com/samples/img1.jpg', 'https://www.hdrsoft.com/samples/img2.jpg', 'https://www.hdrsoft.com/samples/img3.jpg');

// Merge the images from the URLs in the $imagesToProcess array
foreach ($imagesToProcess as $image) {
    $filePath = $imageSourceDir . DIRECTORY_SEPARATOR . $image;
    if (!is_file($filePath)) continue;
    $curl = curl_init("https://hdr-photography.com:8081" . $baseURL . "/images/" . basename($image));
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($curl, CURLOPT_HTTPHEADER, array("x-pm-token: " . $apiKey));
    curl_setopt($curl, CURLOPT_POST, true);
    curl_setopt($curl, CURLOPT_POSTFIELDS, array('image' => file_get_contents($filePath)));    curl_setopt($curl, CURLOPT_POSTFIELDS, array('url' => $image));
    curl_setopt($curl, CURLOPT_HEADER, true);

    $response = curl_exec($curl);
    $jsonResponse = getJsonResponse($curl, $response);

    if ($response === false)
        die("Couldn't add file: " . curl_error($curl));

    if (($respCode = curl_getinfo($curl, CURLINFO_RESPONSE_CODE)) != 201) {
        $jsonResponse = getJsonResponse($curl, $response);
        if (isset($jsonResponse['error']['message']))
            die("Failed to add file: " . $jsonResponse['error']['message']);
        else
            die("Failed to add file: got reponse code " . $respCode);
    }
    curl_close($curl);
}

?>

# Note: This code snippet should appear below the code for step 1 and step 2, in the same script

# Replace with your API key
APIKEY="YOUR_API_KEY"

# The $engineLocation variable was set in step 1
curl -X "POST" -o ResultImage.jpg -H "x-pm-token: $APIKEY" "https://hdr-photography.com:8081$engineLocation/process?preset=Detailed" -F "custom-preset=@MyPresetFile.xmp"
  

<?php

//Note: This code snippet should appear below the code for step 1 and step 2, in the same script

//Replace with your API key
$apiKey = "YOUR_API_KEY";

//The $engineLocation variable that was set in step 1
$baseURL = rtrim($engineLocation, '/');

// Path to the XMP file for your custom preset
$xmpPath = "presets/MyCustomPreset.xmp";

$curl = curl_init("https://hdr-photography.com:8081" . $baseURL . "/process?preset=Detailed");
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, array("x-pm-token: " . $apiKey));
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, array('custom-preset' => file_get_contents($xmpPath)));
$response = curl_exec($curl);
$respCode = curl_getinfo($curl, CURLINFO_RESPONSE_CODE);

if ($response === false)
    die("Couldn't process with preset: " . curl_error($curl));

if ($respCode != 201) {
    $jsonResponse = getJsonResponse($curl, $response);
    if (isset($jsonResponse['error']['message']))
        die("Failed to process bracketed set: " . $jsonResponse['error']['message']);
    else
        die("Failed to process bracketed set: got response code " . $respCode);
}

curl_close($curl);

// Processed image is in $response
header("Content-Type: image/jpeg");
echo $response;

?>

# Note: This code snippet is not dependent on any previous snippets

# Replace with your API key
APIKEY="YOUR_API_KEY"
curl -i -H "x-pm-token: $APIKEY" "https://hdr-photography.com:8081/usage"
  

<?php

// Note: This code snippet is not dependent on any previous snippets


// Replace with your API key
$apiKey = "YOUR_API_KEY";

function getJsonResponse($curl, $response) {
  if ($response === false) return null;
  $headerSize = curl_getinfo($curl, CURLINFO_HEADER_SIZE);
  $body = substr($response, $headerSize);
  return json_decode($body, true);
}

$curl = curl_init("https://hdr-photography.com:8081/usage");
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, array("x-pm-token: " . $apiKey));
curl_setopt($curl, CURLOPT_HEADER, true);

$response = curl_exec($curl);
$respCode = curl_getinfo($curl, CURLINFO_RESPONSE_CODE);
$jsonResponse = getJsonResponse($curl, $response);

?>

<html>
<head>
  <title>Usage details</title>
</head>
<body>

<?php

if ($response === false || $respCode != 200) {
    print("<h1>Error</h1><p>Unable to fetch details for current subscription");
    if (isset($jsonResponse['error']['message']))
        print(": " . $jsonResponse['error']['message']);
    print("</p>");
}
else {
  print("<h1>Subscription details</h1>");
  print("<p>Subscription credits total: " . $jsonResponse['data']['totalCredits'] . "</p>");
  print("<p>Subscription credits remaining: " . $jsonResponse['data']['creditsRemaining'] . "</p>");
}

?>

</body>
</html>