forked from mirrors/gotosocial
5e2bf0bdca
* [chore] Remove years from all license headers Years or year ranges aren't required in license headers. Many projects have removed them in recent years and it avoids a bit of yearly toil. In many cases our copyright claim was also a bit dodgy since we added the 2021-2023 header to files created after 2021 but you can't claim copyright into the past that way. * [chore] Add license header check This ensures a license header is always added to any new file. This avoids maintainers/reviewers needing to remember to check for and ask for it in case a contribution doesn't include it. * [chore] Add missing license headers * [chore] Further updates to license header * Use the more common // indentend comment format * Remove the hack we had for the linter now that we use the // format * Add SPDX license identifier
118 lines
4.2 KiB
Go
118 lines
4.2 KiB
Go
// GoToSocial
|
|
// Copyright (C) GoToSocial Authors admin@gotosocial.org
|
|
// SPDX-License-Identifier: AGPL-3.0-or-later
|
|
//
|
|
// This program is free software: you can redistribute it and/or modify
|
|
// it under the terms of the GNU Affero General Public License as published by
|
|
// the Free Software Foundation, either version 3 of the License, or
|
|
// (at your option) any later version.
|
|
//
|
|
// This program is distributed in the hope that it will be useful,
|
|
// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
// GNU Affero General Public License for more details.
|
|
//
|
|
// You should have received a copy of the GNU Affero General Public License
|
|
// along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
package media
|
|
|
|
import (
|
|
"context"
|
|
"io"
|
|
"time"
|
|
)
|
|
|
|
// mime consts
|
|
const (
|
|
mimeImage = "image"
|
|
mimeVideo = "video"
|
|
|
|
mimeJpeg = "jpeg"
|
|
mimeImageJpeg = mimeImage + "/" + mimeJpeg
|
|
|
|
mimeGif = "gif"
|
|
mimeImageGif = mimeImage + "/" + mimeGif
|
|
|
|
mimePng = "png"
|
|
mimeImagePng = mimeImage + "/" + mimePng
|
|
|
|
mimeWebp = "webp"
|
|
mimeImageWebp = mimeImage + "/" + mimeWebp
|
|
|
|
mimeMp4 = "mp4"
|
|
mimeVideoMp4 = mimeVideo + "/" + mimeMp4
|
|
)
|
|
|
|
// EmojiMaxBytes is the maximum permitted bytes of an emoji upload (50kb)
|
|
// const EmojiMaxBytes = 51200
|
|
|
|
type Size string
|
|
|
|
const (
|
|
SizeSmall Size = "small" // SizeSmall is the key for small/thumbnail versions of media
|
|
SizeOriginal Size = "original" // SizeOriginal is the key for original/fullsize versions of media and emoji
|
|
SizeStatic Size = "static" // SizeStatic is the key for static (non-animated) versions of emoji
|
|
)
|
|
|
|
type Type string
|
|
|
|
const (
|
|
TypeAttachment Type = "attachment" // TypeAttachment is the key for media attachments
|
|
TypeHeader Type = "header" // TypeHeader is the key for profile header requests
|
|
TypeAvatar Type = "avatar" // TypeAvatar is the key for profile avatar requests
|
|
TypeEmoji Type = "emoji" // TypeEmoji is the key for emoji type requests
|
|
)
|
|
|
|
// AdditionalMediaInfo represents additional information that should be added to an attachment
|
|
// when processing a piece of media.
|
|
type AdditionalMediaInfo struct {
|
|
// Time that this media was created; defaults to time.Now().
|
|
CreatedAt *time.Time
|
|
// ID of the status to which this media is attached; defaults to "".
|
|
StatusID *string
|
|
// URL of the media on a remote instance; defaults to "".
|
|
RemoteURL *string
|
|
// Image description of this media; defaults to "".
|
|
Description *string
|
|
// Blurhash of this media; defaults to "".
|
|
Blurhash *string
|
|
// ID of the scheduled status to which this media is attached; defaults to "".
|
|
ScheduledStatusID *string
|
|
// Mark this media as in-use as an avatar; defaults to false.
|
|
Avatar *bool
|
|
// Mark this media as in-use as a header; defaults to false.
|
|
Header *bool
|
|
// X focus coordinate for this media; defaults to 0.
|
|
FocusX *float32
|
|
// Y focus coordinate for this media; defaults to 0.
|
|
FocusY *float32
|
|
}
|
|
|
|
// AdditionalEmojiInfo represents additional information
|
|
// that should be taken into account when processing an emoji.
|
|
type AdditionalEmojiInfo struct {
|
|
// Time that this emoji was created; defaults to time.Now().
|
|
CreatedAt *time.Time
|
|
// Domain the emoji originated from. Blank for this instance's domain. Defaults to "".
|
|
Domain *string
|
|
// URL of this emoji on a remote instance; defaults to "".
|
|
ImageRemoteURL *string
|
|
// URL of the static version of this emoji on a remote instance; defaults to "".
|
|
ImageStaticRemoteURL *string
|
|
// Whether this emoji should be disabled (not shown) on this instance; defaults to false.
|
|
Disabled *bool
|
|
// Whether this emoji should be visible in the instance's emoji picker; defaults to true.
|
|
VisibleInPicker *bool
|
|
// ID of the category this emoji should be placed in; defaults to "".
|
|
CategoryID *string
|
|
}
|
|
|
|
// DataFunc represents a function used to retrieve the raw bytes of a piece of media.
|
|
type DataFunc func(ctx context.Context) (reader io.ReadCloser, fileSize int64, err error)
|
|
|
|
// PostDataCallbackFunc represents a function executed after the DataFunc has been executed,
|
|
// and the returned reader has been read. It can be used to clean up any remaining resources.
|
|
//
|
|
// This can be set to nil, and will then not be executed.
|
|
type PostDataCallbackFunc func(ctx context.Context) error
|