gotosocial/internal/db/model/mediaattachment.go

/*
   GoToSocial
   Copyright (C) 2021 GoToSocial Authors admin@gotosocial.org

   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 model

import (
	"time"
)

// MediaAttachment represents a user-uploaded media attachment: an image/video/audio/gif that is
// somewhere in storage and that can be retrieved and served by the router.
type MediaAttachment struct {
	// ID of the attachment in the database
	ID string `pg:"type:uuid,default:gen_random_uuid(),pk,notnull,unique"`
	// ID of the status to which this is attached
	StatusID string
	// Where can the attachment be retrieved on a remote server
	RemoteURL string
	// When was the attachment created
	CreatedAt time.Time `pg:"type:timestamp,notnull,default:now()"`
	// When was the attachment last updated
	UpdatedAt time.Time `pg:"type:timestamp,notnull,default:now()"`
	// Type of file (image/gif/audio/video)
	Type FileType `pg:",notnull"`
	// Metadata about the file
	FileMeta FileMeta
	// To which account does this attachment belong
	AccountID string `pg:",notnull"`
	// Description of the attachment (for screenreaders)
	Description string
	// To which scheduled status does this attachment belong
	ScheduledStatusID string
	// What is the generated blurhash of this attachment
	Blurhash string
	// What is the processing status of this attachment
	Processing ProcessingStatus
	// metadata for the whole file
	File
	// small image thumbnail derived from a larger image, video, or audio file.
	Thumbnail
	// Is this attachment being used as an avatar?
	Avatar bool
	// Is this attachment being used as a header?
	Header bool
}

// File refers to the metadata for the whole file
type File struct {
	// What is the path of the file in storage.
	Path string
	// What is the MIME content type of the file.
	ContentType string
	// What is the size of the file in bytes.
	FileSize int
	// When was the file last updated.
	UpdatedAt time.Time `pg:"type:timestamp,default:now()"`
}

// Thumbnail refers to a small image thumbnail derived from a larger image, video, or audio file.
type Thumbnail struct {
	// What is the path of the file in storage
	Path string
	// What is the MIME content type of the file.
	ContentType string
	// What is the size of the file in bytes
	FileSize int
	// When was the file last updated
	UpdatedAt time.Time `pg:"type:timestamp,default:now()"`
	// What is the remote URL of the thumbnail
	RemoteURL string
}

// ProcessingStatus refers to how far along in the processing stage the attachment is.
type ProcessingStatus int

const (
	// ProcessingStatusReceived: the attachment has been received and is awaiting processing. No thumbnail available yet.
	ProcessingStatusReceived ProcessingStatus = 0
	// ProcessingStatusProcessing: the attachment is currently being processed. Thumbnail is available but full media is not.
	ProcessingStatusProcessing ProcessingStatus = 1
	// ProcessingStatusProcessed: the attachment has been fully processed and is ready to be served.
	ProcessingStatusProcessed ProcessingStatus = 2
	// ProcessingStatusError: something went wrong processing the attachment and it won't be tried again--these can be deleted.
	ProcessingStatusError ProcessingStatus = 666
)

// FileType refers to the file type of the media attaachment.
type FileType string

const (
	// FileTypeImage is for jpegs and pngs
	FileTypeImage FileType = "image"
	// FileTypeGif is for native gifs and soundless videos that have been converted to gifs
	FileTypeGif FileType = "gif"
	// FileTypeAudio is for audio-only files (no video)
	FileTypeAudio FileType = "audio"
	// FileTypeVideo is for files with audio + visual
	FileTypeVideo FileType = "video"
)

/*
	FILEMETA INTERFACES
*/

// FileMeta describes metadata about the actual contents of the file.
type FileMeta interface {
	GetOriginal() OriginalMeta
	GetSmall() SmallMeta
}

// OriginalMeta contains info about the originally submitted media
type OriginalMeta interface {
	// GetWidth gets the width of a video or image or gif in pixels.
	GetWidth() int
	// GetHeight gets the height of a video or image or gif in pixels.
	GetHeight() int
	// GetSize gets the total area of a video or image or gif in pixels (width * height).
	GetSize() int
	// GetAspect gets the aspect ratio of a video or image or gif in pixels (width / height).
	GetAspect() float64
	// GetFrameRate gets the FPS of a video or gif.
	GetFrameRate() float64
	// GetDuration gets the length in seconds of a video or gif or audio file.
	GetDuration() float64
	// GetBitrate gets the bits per second of a video, gif, or audio file.
	GetBitrate() float64
}

// SmallMeta contains info about the derived thumbnail for the submitted media
type SmallMeta interface {
	// GetWidth gets the width of a video or image or gif in pixels.
	GetWidth() int
	// GetHeight gets the height of a video or image or gif in pixels.
	GetHeight() int
	// GetSize gets the total area of a video or image or gif in pixels (width * height).
	GetSize() int
	// GetAspect gets the aspect ratio of a video or image or gif in pixels (width / height).
	GetAspect() float64
}

/*
	FILE META IMPLEMENTATIONS
*/

// Small implements SmallMeta and can be used for a thumbnail of any media type
type Small struct {
	Width  int
	Height int
	Size   int
	Aspect float64
}

func (s Small) GetWidth() int {
	return s.Width
}

func (s Small) GetHeight() int {
	return s.Height
}

func (s Small) GetSize() int {
	return s.Height * s.Width
}

func (s Small) GetAspect() float64 {
	return float64(s.Width) / float64(s.Height)
}

// STILL IMAGES

// ImageFileMeta implements FileMeta for still images.
type ImageFileMeta struct {
	Original ImageOriginal
	Small    Small
}

func (m ImageFileMeta) GetOriginal() OriginalMeta {
	return m.Original
}

func (m ImageFileMeta) GetSmall() SmallMeta {
	return m.Small
}

// ImageOriginal implements OriginalMeta for still images
type ImageOriginal struct {
	Width  int
	Height int
	Size   int
	Aspect float64
}

func (o ImageOriginal) GetWidth() int {
	return o.Width
}

func (o ImageOriginal) GetHeight() int {
	return o.Height
}

func (o ImageOriginal) GetSize() int {
	return o.Height * o.Width
}

func (o ImageOriginal) GetAspect() float64 {
	return float64(o.Width) / float64(o.Height)
}

func (o ImageOriginal) GetFrameRate() float64 {
	return 0
}

func (o ImageOriginal) GetDuration() float64 {
	return 0
}

func (o ImageOriginal) GetBitrate() float64 {
	return 0
}