setZoomTargets

Last update: 2022-03-08
  • Created for:
  • Developer
    Admin

Sets the zoom target associated with an asset image. It overwrites existing zoom targets.

Syntax

Authorizied User Types

  • IpsUser
  • IpsAdmin
  • IpsCompanyAdmin
  • ImagePortalAdmin
  • ImagePortalContrib
  • ImagePortalContribUser

Parameters

Input (setZoomTargetsParam)

Name Type Required Description
companyHandle xsd:string Yes Company handle.
assetHandle xsd:string Yes Asset with the zoom target you want to set.
zoomTargetArray types:ZoomTargetDefinitionArray Yes Array of zoom target definitions.

Output (setZoomTargetsReturn)

Name Type Required Description
zoomTargetHandleArray types:HandleArray Yes The set of handles to the zoom targets created by this operation.

Examples

This code sample defines an array of zoom targets by name, position (x and y axis), width, height, and assigns the array to an asset. The response contains handles to the newly created zoom targets.

Request

<setZoomTargetsParam xmlns="http://www.scene7.com/IpsApi/xsd/2008-01-15">
   <companyHandle>c|6</companyHandle>
   <assetHandle>a|739|1|537</assetHandle>
   <zoomTargetArray>
      <items>
         <name>zoomTarget2</name>
         <xPosition>40</xPosition>
         <yPosition>40</yPosition>
         <width>400</width>
         <height>400</height>
      </items>
      <items>
         <name>zoomTarget3</name>
         <xPosition>40</xPosition>
         <yPosition>40</yPosition>
         <width>400</width>
         <height>400</height>
      </items>
   </zoomTargetArray>
</setZoomTargetsParam>

Response

<setZoomTargetsReturn xmlns="http://www.scene7.com/IpsApi/xsd/2008-01-15">
   <zoomTargetHandleArray>
      <items>a|947|9|41</items>
      <items>a|948|9|42</items>
   </zoomTargetHandleArray>
</setZoomTargetsReturn>

On this page