67 lines
2 KiB
Go
67 lines
2 KiB
Go
// Copyright 2012 Google Inc. All rights reserved.
|
|
// Use of this source code is governed by the Apache 2.0
|
|
// license that can be found in the LICENSE file.
|
|
|
|
// Package image provides image services.
|
|
package image // import "google.golang.org/appengine/image"
|
|
|
|
import (
|
|
"fmt"
|
|
"net/url"
|
|
|
|
"golang.org/x/net/context"
|
|
|
|
"google.golang.org/appengine"
|
|
"google.golang.org/appengine/internal"
|
|
pb "google.golang.org/appengine/internal/image"
|
|
)
|
|
|
|
type ServingURLOptions struct {
|
|
Secure bool // whether the URL should use HTTPS
|
|
|
|
// Size must be between zero and 1600.
|
|
// If Size is non-zero, a resized version of the image is served,
|
|
// and Size is the served image's longest dimension. The aspect ratio is preserved.
|
|
// If Crop is true the image is cropped from the center instead of being resized.
|
|
Size int
|
|
Crop bool
|
|
}
|
|
|
|
// ServingURL returns a URL that will serve an image from Blobstore.
|
|
func ServingURL(c context.Context, key appengine.BlobKey, opts *ServingURLOptions) (*url.URL, error) {
|
|
req := &pb.ImagesGetUrlBaseRequest{
|
|
BlobKey: (*string)(&key),
|
|
}
|
|
if opts != nil && opts.Secure {
|
|
req.CreateSecureUrl = &opts.Secure
|
|
}
|
|
res := &pb.ImagesGetUrlBaseResponse{}
|
|
if err := internal.Call(c, "images", "GetUrlBase", req, res); err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
// The URL may have suffixes added to dynamically resize or crop:
|
|
// - adding "=s32" will serve the image resized to 32 pixels, preserving the aspect ratio.
|
|
// - adding "=s32-c" is the same as "=s32" except it will be cropped.
|
|
u := *res.Url
|
|
if opts != nil && opts.Size > 0 {
|
|
u += fmt.Sprintf("=s%d", opts.Size)
|
|
if opts.Crop {
|
|
u += "-c"
|
|
}
|
|
}
|
|
return url.Parse(u)
|
|
}
|
|
|
|
// DeleteServingURL deletes the serving URL for an image.
|
|
func DeleteServingURL(c context.Context, key appengine.BlobKey) error {
|
|
req := &pb.ImagesDeleteUrlBaseRequest{
|
|
BlobKey: (*string)(&key),
|
|
}
|
|
res := &pb.ImagesDeleteUrlBaseResponse{}
|
|
return internal.Call(c, "images", "DeleteUrlBase", req, res)
|
|
}
|
|
|
|
func init() {
|
|
internal.RegisterErrorCodeMap("images", pb.ImagesServiceError_ErrorCode_name)
|
|
}
|