area

Documentation

Overview

Package area provides functions working with image areas.

Index

• func ExcludeBorder(area image.Rectangle) image.Rectangle
• func FromSize(size image.Point) (image.Rectangle, error)
• func HSplit(area image.Rectangle, heightPerc int) (top image.Rectangle, bottom image.Rectangle, err error)
• func Size(area image.Rectangle) image.Point
• func VSplit(area image.Rectangle, widthPerc int) (left image.Rectangle, right image.Rectangle, err error)
• func WithRatio(area image.Rectangle, ratio image.Point) image.Rectangle

Functions

func ExcludeBorder

func ExcludeBorder(area image.Rectangle) image.Rectangle

ExcludeBorder returns a new area created by subtracting a border around the provided area. Return the zero area if there isn't enough space to exclude the border.

func FromSize

func FromSize(size image.Point) (image.Rectangle, error)

FromSize returns the corresponding area for the provided size.

func HSplit

func HSplit(area image.Rectangle, heightPerc int) (top image.Rectangle, bottom image.Rectangle, err error)

HSplit returns two new areas created by splitting the provided area at the specified percentage of its width. The percentage must be in the range 0 <= heightPerc <= 100. Can return zero size areas.

func Size

func Size(area image.Rectangle) image.Point

Size returns the size of the provided area.

func VSplit

func VSplit(area image.Rectangle, widthPerc int) (left image.Rectangle, right image.Rectangle, err error)

VSplit returns two new areas created by splitting the provided area at the specified percentage of its width. The percentage must be in the range 0 <= widthPerc <= 100. Can return zero size areas.

func WithRatio

func WithRatio(area image.Rectangle, ratio image.Point) image.Rectangle

WithRatio returns the largest area that has the requested ratio but is either equal or smaller than the provided area. Returns zero area if the area or the ratio are zero, or if there is no such area.