CONTENTdm Website API Reference - utils
- Last updated
-
-
Save as PDF
The following API functions are handled by the utils controller on the CONTENTdm Website, instead of by dmwebservices on the CONTENTdm Server. The utils functions return binary data, where the dmwebservices functions return text in XML or JSON format. These functions also differ in that utils calls are relative to the URL of the CONTENTdm Website, but dmwebservices calls are absolute, requiring the full URL of the CONTENTdm Server.
- GetFile
-
Signature |
Returns |
/utils/getfile/collection/alias/id/pointer/filename/name
- alias is the collection alias
- pointer is the pointer to the item in the collection
- name is the file name to use when saving the file
|
Returns the stored file for the specified item. The call will enforce access control defined for the item.
|
- GetImage
-
Signature |
Returns |
/utils/ajaxhelper/?CISOROOT=alias&CISOPTR=pointer&action=2&
DMSCALE=scale&DMWIDTH=width&DMHEIGHT=height&
DMX=x&DMY=y&DMTEXT=text&DMROTATE=degrees
- alias is the collection alias
- pointer is the pointer to the item in the collection
- scale is the percentage to scale the image
- width is the image width in pixels
- height is the image height in pixels
- x is the x-coordinate of the upper-left corner of the cropped-out region
- y is the y-coordinate of the upper-left corner of the cropped-out region
- text is the words to be highlighted in the image. Requires bounding box information to be stored for the item; otherwise no highlighting occurs
- degrees is the number of degrees to rotate the image
|
Returns a scaled and cropped image for display. The specified item must be an image.
The returned image is in JPEG format.
|
- GetStream
-
Signature |
Returns |
utils/getstream/collection/alias/id/pointer
- alias is the collection alias
- pointer is the pointer to the item in the collection
|
Plays the stream for the specified item. |
- GetThumbnail
-
Signature |
Returns |
/utils/getthumbnail/collection/alias/id/pointer
- alias is the collection alias
- pointer is the pointer to the item in the collection
|
Returns the thumbnail for the specified item. The thumbnail is a JPEG image
of maximum dimensions 160 x 120 pixels. |