public interface IImagesServiceFactory
| Modifier and Type | Method and Description |
|---|---|
ImagesService |
getImagesService()
Creates an implementation of the ImagesService.
|
Composite |
makeComposite(Image image,
int xOffset,
int yOffset,
float opacity,
Composite.Anchor anchor)
Creates an image composition operation.
|
CompositeTransform |
makeCompositeTransform()
Creates a composite transform that can represent multiple transforms
applied in series.
|
CompositeTransform |
makeCompositeTransform(java.util.Collection<Transform> transforms)
Creates a composite transform that can represent multiple transforms
applied in series.
|
Transform |
makeCrop(double leftX,
double topY,
double rightX,
double bottomY)
Creates a transform that will crop an image to fit within the bounding
box specified.
|
Transform |
makeCrop(float leftX,
float topY,
float rightX,
float bottomY)
Creates a transform that will crop an image to fit within the bounding
box specified.
|
Transform |
makeHorizontalFlip()
Creates a transform that will horizontally flip an image.
|
Image |
makeImage(byte[] imageData)
Creates an image from the provided
imageData. |
Image |
makeImageFromBlob(BlobKey blobKey)
Create an image backed by the specified
blobKey. |
Image |
makeImageFromFilename(java.lang.String filename)
Create an image backed by the specified
filename. |
Transform |
makeImFeelingLucky()
Creates a transform that automatically adjust contrast and color levels.
|
Transform |
makeResize(int width,
int height)
Creates a transform that will resize an image to fit within a box with
width
width and height height. |
Transform |
makeResize(int width,
int height,
boolean allowStretch)
Creates a resize transform that will resize an image to fit within a box
of width
width and height height. |
Transform |
makeResize(int width,
int height,
double cropOffsetX,
double cropOffsetY)
Creates a transform that will resize an image to exactly fit a box with
width
width and height height by resizing to the less
constraining dimension and cropping the other. |
Transform |
makeResize(int width,
int height,
float cropOffsetX,
float cropOffsetY)
Creates a transform that will resize an image to exactly fit a box with
width
width and height height by resizing to the less
constraining dimension and cropping the other. |
Transform |
makeRotate(int degrees)
Creates a transform that rotates an image by
degrees degrees
clockwise. |
Transform |
makeVerticalFlip()
Creates a transform that will vertically flip an image.
|
ImagesService getImagesService()
Image makeImage(byte[] imageData)
imageData.imageData - image data to store in the imagejava.lang.IllegalArgumentException - If imageData is null or empty.Image makeImageFromBlob(BlobKey blobKey)
blobKey. Note
that the returned Image object can be used with all
ImagesService methods, but most of the methods on the
Image itself will currently throw UnsupportedOperationException.blobKey - referencing the imageImage makeImageFromFilename(java.lang.String filename)
filename. Note
that the returned Image object can be used with all
ImagesService methods, but most of the methods on the
Image itself will currently throw UnsupportedOperationException.filename - referencing the image. Currently only Google Storage files
in the format "/gs/bucket_name/object_name" are supported.java.lang.IllegalArgumentException - If filename is not in the format
"/gs/bucket_name/object_name".BlobstoreFailureException - If there is an error obtaining the Google
Storage access token for the filename.Transform makeResize(int width, int height)
width and height height.width - width of the bounding boxheight - height of the bounding boxjava.lang.IllegalArgumentException - If width or height are
negative or greater than MAX_RESIZE_DIMENSIONS or if both
width and height are 0.Transform makeResize(int width, int height, boolean allowStretch)
width and height height. If allowStretch
is true, the aspect ratio of the original image will be ignored.width - width of the bounding boxheight - height of the bounding boxallowStretch - allow the image to be resized ignoring the aspect ratiojava.lang.IllegalArgumentException - If width or height are negative or greater
than MAX_RESIZE_DIMENSIONS, if both width and height are 0 or
if allowStretch is True and either width or height are 0.Transform makeResize(int width, int height, float cropOffsetX, float cropOffsetY)
width and height height by resizing to the less
constraining dimension and cropping the other. The center of the crop
region is controlled by cropOffsetX and cropOffsetY.width - width of the bounding boxheight - height of the bounding boxcropOffsetX - the relative horizontal position of the centercropOffsetY - the relative vertical position of the centerjava.lang.IllegalArgumentException - If width or height are
negative or greater than MAX_RESIZE_DIMENSIONS, if either of
width and height are 0 or if cropOffsetX or
cropOffsetY are outside the range 0.0 to 1.0.Transform makeResize(int width, int height, double cropOffsetX, double cropOffsetY)
width and height height by resizing to the less
constraining dimension and cropping the other. The center of the crop
region is controlled by cropOffsetX and cropOffsetY.width - width of the bounding boxheight - height of the bounding boxcropOffsetX - the relative horizontal position of the centercropOffsetY - the relative vertical position of the centerjava.lang.IllegalArgumentException - If width or height are
negative or greater than MAX_RESIZE_DIMENSIONS, if either of
width and height are 0 or if cropOffsetX or
cropOffsetY are outside the range 0.0 to 1.0.Transform makeCrop(float leftX, float topY, float rightX, float bottomY)
leftX - X coordinate of the top left corner of the bounding boxtopY - Y coordinate of the top left corner of the bounding boxrightX - X coordinate of the bottom right corner of the bounding boxbottomY - Y coordinate of the bottom right corner of the bounding boxjava.lang.IllegalArgumentException - If any of the arguments are outside the
range 0.0 to 1.0 or if leftX >= rightX or topY >= bottomY.Transform makeCrop(double leftX, double topY, double rightX, double bottomY)
leftX - X coordinate of the top left corner of the bounding boxtopY - Y coordinate of the top left corner of the bounding boxrightX - X coordinate of the bottom right corner of the bounding boxbottomY - Y coordinate of the bottom right corner of the bounding boxjava.lang.IllegalArgumentException - If any of the arguments are outside the
range 0.0 to 1.0 or if leftX >= rightX or topY >= bottomY.Transform makeVerticalFlip()
Transform makeHorizontalFlip()
Transform makeRotate(int degrees)
degrees degrees
clockwise.degrees - The number of degrees by which to rotate. Must be a
multiple of 90.java.lang.IllegalArgumentException - If degrees is not divisible by 90Transform makeImFeelingLucky()
CompositeTransform makeCompositeTransform(java.util.Collection<Transform> transforms)
transforms - Transforms for this composite transform to apply.CompositeTransform makeCompositeTransform()
Composite makeComposite(Image image, int xOffset, int yOffset, float opacity, Composite.Anchor anchor)
image - The image to be composited.xOffset - Offset in the x axis from the anchor point.yOffset - Offset in the y axis from the anchor point.opacity - Opacity to be used for the image in range [0.0, 1.0].anchor - Anchor position from the enum Composite.Anchor.
The anchor position of the image is aligned with the anchor position of
the canvas and then the offsets are applied.java.lang.IllegalArgumentException - If image is null or empty,
xOffset or yOffset is outside the range
[-4000,
4000],
opacity is outside the range [0.0, 1.0] or anchor is null.