juroku

package module

v0.0.0-...-0378288 Latest Latest Go to latest Published: Feb 4, 2023 License: MIT Imports: 20 Imported by: 0

Details

Valid go.mod file

The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license

Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version

Modules with tagged versions give importers more predictable builds.
Stable version

When a project reaches major version v1 it is considered stable.
Learn more about best practices

Repository

github.com/dwasint/juroku

Links

Open Source Insights

README ¶

Juroku

Juroku converts an image (PNG or JPG) into a Lua script that can be loaded as a ComputerCraft API to be used to draw on terminals and monitors.

Building and Running

A cgo security exception is required to allow the libimagequant to build:

export CGO_CFLAGS_ALLOW=.*
export CGO_LDFLAGS_ALLOW=.*

go get -u github.com/tmpim/juroku/cmd/juroku
Find juroku in your $GOPATH/bin and run it.

TODO: Release pre-built binaries.

Usage:

Usage: juroku [options] input_image

Juroku converts an image (PNG or JPG) into a Lua script that can be
loaded as a ComputerCraft API to be used to draw on terminals and monitors.
Images are not automatically downscaled or cropped.

input_image must have a height that is a multiple of 3 in pixels,
and a width that is a multiple of 2 in pixels.

Options:
  -d float
    	set the amount of allowed dithering (0 = none, 1 = most) (default 0.2)
  -license
    	show GPLv3 licensing disclaimer
  -o string
    	set location of output script (default "image.lua")
  -p string
    	set location of output preview (will be PNG) (default "preview.png")
  -q int
    	set the processing speed/quality (1 = slowest, 10 = fastest) (default 1)

Disclaimer

Juroku when built contains libimagequant which is licensed under GPLv3. For more information and the source code of the relevant portions, see: https://github.com/1lann/imagequant.

Documentation ¶

Index ¶

func ChunkImage(img image.Image) (image.Image, error)
func EncodeVideo(rd io.Reader, output chan<- VideoChunk, opts EncoderOptions) error
func GetPalette(img image.Image) color.Palette
func Quantize(ref, img image.Image, speed int, dither float64) (image.Image, error)
type AudioChunk
- func (a AudioChunk) WriteTo(w io.Writer) error
type EncoderOptions
type FrameChunk
- func GenerateFrameChunk(img image.Image) (*FrameChunk, error)
- func (f *FrameChunk) WriteTo(w io.Writer) error
type FrameRow
- func (f *FrameRow) WriteTo(wr io.Writer) (int, error)
type FrameSplitter
type VideoChunk

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

func ChunkImage ¶

func ChunkImage(img image.Image) (image.Image, error)

ChunkImage chunks an image following the ComputerCraft requirements of maximum of 2 colors per 2x3 chunk of pixels and returns it. It is assumed that the palette has already been reduced to 16 colors.

func EncodeVideo ¶

func EncodeVideo(rd io.Reader, output chan<- VideoChunk,
	opts EncoderOptions) error

EncodeVideo encodes the video from the given reader which can be of any format that FFMPEG supports, into the output.

func GetPalette ¶

func GetPalette(img image.Image) color.Palette

GetPalette returns the palette of the image.

func Quantize ¶

func Quantize(ref, img image.Image, speed int, dither float64) (image.Image, error)

Quantize quantizes an image into a maximum of 16 colors with the given parameters.

Types ¶

type AudioChunk ¶

type AudioChunk []byte

AudioChunk represents a chunk of audio data.

func (AudioChunk) WriteTo ¶

func (a AudioChunk) WriteTo(w io.Writer) error

type EncoderOptions ¶

type EncoderOptions struct {
	Context     context.Context
	Width       int
	Height      int
	Workers     int
	Speed       int
	Dither      float64
	AudioBuffer time.Duration
	Debug       bool
	Splitter    FrameSplitter
}

type FrameChunk ¶

type FrameChunk struct {
	Width  int
	Height int

	Rows []FrameRow

	Palette [16]color.RGBA
}

FrameChunk represents a frame chunk.

func GenerateFrameChunk ¶

func GenerateFrameChunk(img image.Image) (*FrameChunk, error)

GenerateFrameChunk generates a frame chunk for the given image.

func (*FrameChunk) WriteTo ¶

func (f *FrameChunk) WriteTo(w io.Writer) error

WriteTo writes the frame chunk to a writer.

type FrameRow ¶

type FrameRow struct {
	TextColor       *bytes.Buffer
	BackgroundColor *bytes.Buffer
	Text            *bytes.Buffer
}

FrameRow represents a row in a frame chunk.

func (*FrameRow) WriteTo ¶

func (f *FrameRow) WriteTo(wr io.Writer) (int, error)

WriteTo writes the frame row to a writer.

type FrameSplitter ¶

type FrameSplitter func(img image.Image) []image.Image

FrameSplitter splits an image into multiple frames for multiple monitors.

type VideoChunk ¶

type VideoChunk struct {
	Frames []*FrameChunk
	Audio  AudioChunk
}

VideoChunk is composed of a Frame and Audio chunk.

Source Files ¶

View all Source files

Directories ¶

Path	Synopsis
cmd
dfpwm
exp
juroku
video
dfpwm

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL