mediaops

type EditConfig struct {
	Python      string        // resolved PIL python ("" = absent)
	GimpConsole string        // gimp-console path ("" = absent)
	Worker      string        // absolute path of render/edit_image.py
	Timeout     time.Duration // edit_timeout_sec
}

type EditOp struct {
	Op string `json:"op"`
	// crop / composite / text placement
	X      int `json:"x,omitempty"`
	Y      int `json:"y,omitempty"`
	Width  int `json:"width,omitempty"`
	Height int `json:"height,omitempty"`
	// resize
	KeepAspect *bool `json:"keep_aspect,omitempty"`
	// convert
	Format string `json:"format,omitempty"`
	// composite
	Overlay string  `json:"overlay,omitempty"`
	Opacity float64 `json:"opacity,omitempty"`
	// text
	Text   string `json:"text,omitempty"`
	Size   int    `json:"size,omitempty"`
	Color  string `json:"color,omitempty"`
	Font   string `json:"font,omitempty"`
	Anchor string `json:"anchor,omitempty"`
	// mask_boxes (white-on-black inpaint mask builder; REPLACES the working image)
	Boxes   []MaskBox `json:"boxes,omitempty"`
	Feather int       `json:"feather,omitempty"`
	Pad     int       `json:"pad,omitempty"`
	Invert  bool      `json:"invert,omitempty"`
	// perspective_composite (overlay reused; quad = 4 [x,y] dest corners UL,UR,LR,LL)
	Quad [][]float64 `json:"quad,omitempty"`
	// lut_cube (.cube 3D LUT; strength 0-1 blends graded over original, nil = 1.0)
	Path     string   `json:"path,omitempty"`
	Strength *float64 `json:"strength,omitempty"`
	// grade (tone/color: everything composes into ONE LUT per channel, single quantize)
	Levels        *GradeLevels `json:"levels,omitempty"`
	Curve         *GradeCurve  `json:"curve,omitempty"`
	WB            *GradeWB     `json:"wb,omitempty"`
	LuminanceOnly bool         `json:"luminance_only,omitempty"`
	// finish (delivery sharpening — MUST be the LAST op, after any resize:
	// sharpening before a resize is undone by resampling)
	Sharpen *FinishSharpen `json:"sharpen,omitempty"`
	Median  int            `json:"median,omitempty"`
	// instantiate_design (FIRST op only; GIMP layered-template factory —
	// layer name -> new text copy / replacement image path)
	SetText      map[string]string `json:"set_text,omitempty"`
	ReplaceImage map[string]string `json:"replace_image,omitempty"`
}

type EditRequest struct {
	Image      string
	Ops        []EditOp
	Out        string
	Renditions []Rendition // optional export matrix derived from the master Out
}

type EditResult struct {
	Out        string   `json:"image_path"`
	Width      int      `json:"width"`
	Height     int      `json:"height"`
	OpsApplied int      `json:"ops_applied"`
	Layers     []Layer  `json:"layers,omitempty"`
	Renditions []string `json:"renditions,omitempty"`
	Engine     string   `json:"engine"`
}

type FinishSharpen struct {
	Radius    *float64 `json:"radius,omitempty"`
	Percent   *int     `json:"percent,omitempty"`
	Threshold *int     `json:"threshold,omitempty"`
}

type GradeCurve struct {
	Points [][]float64 `json:"points"`
}

type GradeLevels struct {
	Black int     `json:"black,omitempty"`
	White int     `json:"white,omitempty"`
	Gamma float64 `json:"gamma,omitempty"`
}

type GradeWB struct {
	Mode string  `json:"mode"`
	R    float64 `json:"r,omitempty"`
	G    float64 `json:"g,omitempty"`
	B    float64 `json:"b,omitempty"`
}

type Layer struct {
	Name    string `json:"name"`
	Visible bool   `json:"visible"`
}

type MaskBox struct {
	X      int `json:"x"`
	Y      int `json:"y"`
	Width  int `json:"width"`
	Height int `json:"height"`
}

type MediaConfig struct {
	FFmpeg  string        // ffmpeg_path ("" = absent)
	Timeout time.Duration // edit_timeout_sec governs media ops too
}

type MediaRequest struct {
	Op        string   // trim | concat | extract_frames | convert | mux_audio | probe
	In        string   // input path (all ops except concat)
	Inputs    []string // concat inputs (>=2)
	ListPath  string   // concat: path of the demuxer list file the caller wrote
	Out       string   // output path (probe: unused)
	Start     string   // trim: seconds or hh:mm:ss
	End       string   // trim: absolute end time (resolved to Duration in RunMedia)
	Duration  string   // trim: seconds
	FPS       float64  // extract_frames: sampling rate
	Count     int      // extract_frames: total frames (resolved to FPS via probe in RunMedia)
	Audio     string   // mux_audio: audio input path
	Shortest  bool     // mux_audio: stop at the shorter input (default true at the handler)
	Reencode  bool     // trim: re-encode for exact cuts instead of keyframe-snapped -c copy
	AudioOnly bool     // convert: drop video (-vn)
	VideoOnly bool     // convert: drop audio (-an)
}

type MediaResult struct {
	MediaPath   string   `json:"media_path,omitempty"`
	DurationSec float64  `json:"duration_sec,omitempty"`
	Frames      []string `json:"frames,omitempty"`
	Count       int      `json:"count,omitempty"`
	Probe       *Probe   `json:"probe,omitempty"`
}

type Probe struct {
	DurationSec float64       `json:"duration_sec"`
	Format      string        `json:"format"`
	Streams     []ProbeStream `json:"streams"`
}

type ProbeStream struct {
	Type       string  `json:"type"` // video | audio
	Codec      string  `json:"codec"`
	Width      int     `json:"width,omitempty"`
	Height     int     `json:"height,omitempty"`
	FPS        float64 `json:"fps,omitempty"`
	SampleRate int     `json:"sample_rate,omitempty"`
}

type Rendition struct {
	Width  int    `json:"width,omitempty"`
	Height int    `json:"height,omitempty"`
	Format string `json:"format"`
	Suffix string `json:"suffix"`
}