306b829431
This relies on type aliases, a language feature new in Go 1.9.
The package documentation, in draw.go, explicitly gives the intent of
this package:
This package is a superset of and a drop-in replacement for the
image/draw package in the standard library.
Drop-in replacement means that I can replace all of my "image/draw"
imports with "golang.org/x/image/draw", to access additional features in
this package, and no further changes are required. That's mostly true,
but not completely true unless we use type aliases.
Without type aliases, users might need to import both "image/draw" and
"golang.org/x/image/draw" in order to convert from two conceptually
equivalent but different (from the compiler's point of view) types, such
as from one draw.Op type to another draw.Op type, to satisfy some other
interface or function signature.
Change-Id: Ice6d000d49b019c2d8761739a904232e9cd01cae
Reviewed-on: https://go-review.googlesource.com/36730
Run-TryBot: Nigel Tao <nigeltao@golang.org>
TryBot-Result: Gobot Gobot <gobot@golang.org>
Reviewed-by: Rob Pike <r@golang.org>
Reviewed-by: Russ Cox <rsc@golang.org>
58 lines
1.9 KiB
Go
58 lines
1.9 KiB
Go
// Copyright 2016 The Go Authors. All rights reserved.
|
|
// Use of this source code is governed by a BSD-style
|
|
// license that can be found in the LICENSE file.
|
|
|
|
// +build go1.9
|
|
|
|
package draw
|
|
|
|
import (
|
|
"image/draw"
|
|
)
|
|
|
|
// We use type aliases (new in Go 1.9) for the exported names from the standard
|
|
// library's image/draw package. This is not merely syntactic sugar for
|
|
//
|
|
// type Drawer draw.Drawer
|
|
//
|
|
// as aliasing means that the types in this package, such as draw.Image and
|
|
// draw.Op, are identical to the corresponding draw.Image and draw.Op types in
|
|
// the standard library. In comparison, prior to Go 1.9, the code in go1_8.go
|
|
// defines new types that mimic the old but are different types.
|
|
//
|
|
// The package documentation, in draw.go, explicitly gives the intent of this
|
|
// package:
|
|
//
|
|
// This package is a superset of and a drop-in replacement for the
|
|
// image/draw package in the standard library.
|
|
//
|
|
// Drop-in replacement means that I can replace all of my "image/draw" imports
|
|
// with "golang.org/x/image/draw", to access additional features in this
|
|
// package, and no further changes are required. That's mostly true, but not
|
|
// completely true unless we use type aliases.
|
|
//
|
|
// Without type aliases, users might need to import both "image/draw" and
|
|
// "golang.org/x/image/draw" in order to convert from two conceptually
|
|
// equivalent but different (from the compiler's point of view) types, such as
|
|
// from one draw.Op type to another draw.Op type, to satisfy some other
|
|
// interface or function signature.
|
|
|
|
// Drawer contains the Draw method.
|
|
type Drawer = draw.Drawer
|
|
|
|
// Image is an image.Image with a Set method to change a single pixel.
|
|
type Image = draw.Image
|
|
|
|
// Op is a Porter-Duff compositing operator.
|
|
type Op = draw.Op
|
|
|
|
const (
|
|
// Over specifies ``(src in mask) over dst''.
|
|
Over Op = draw.Over
|
|
// Src specifies ``src in mask''.
|
|
Src Op = draw.Src
|
|
)
|
|
|
|
// Quantizer produces a palette for an image.
|
|
type Quantizer = draw.Quantizer
|