y4mscaler - Online sa Cloud

PROGRAMA:

NAME

y4mscaler - I-scale/i-crop/isalin ang isang stream ng YUV4MPEG2

SINOPSIS

y4mscaler [pagpipilian] < Y4Mstream > Y4Mstream

DESCRIPTION

y4mscaler ay isang general-purpose video scaler na gumagana sa YUV4MPEG2 stream, bilang
ginawa at ginagamit ng MJPEGtools tulad ng lav2yuv at mpeg2encNa (1).

y4mscaler ay nilalayong gamitin sa isang pipeline. Kaya, ang input ay mula sa stdin, at ang output ay sa
stdout.

Ang mahahalagang tungkulin ng y4mscaler ay upang sukatin ang isang tinukoy na "aktibo" na rehiyon ng input
stream (ang pinagmulan) sa isang tinukoy na aktibong rehiyon ng output stream (ang target).
Ang mga pixel sa labas ng aktibong rehiyon ng pinagmulan ay binabalewala; mga pixel sa labas ng
ang aktibong rehiyon ng target ay puno ng kulay ng background. Ang pinagmulan ay maaaring
Bukod pa rito ay may matte na inilapat dito; ang mga pixel sa labas ng source matte ay nakatakda sa a
hiwalay na tinukoy na kulay ng background.

y4mscaler wastong pinangangasiwaan ang chroma subsampling, at sa gayon ay maaari rin itong magsagawa ng chroma
mga subsampling na conversion. Sinusuportahan ng YUV4MPEG2 stream format ang tatlong uri ng 4:2:0
subsampling, pati na rin ang 4:1:1, 4:2:2, 4:4:4, isang 4:4:4 mode na may alpha channel, at isang
monochrome luma-only na mode. (Tingnan ang "NOTES ON CHROMA MODES AND SUBSAMPLING".)

y4mscaler maaaring magsagawa ng mga simpleng interlacing na conversion: paglipat mula sa top-field-first sa
bottom-field-first at vice-versa (sa pamamagitan ng lossily discarding the first field), at paggawa ng a
progresibong stream mula sa interlaced sa pamamagitan ng pagtatapon sa bawat iba pang field (epektibong paghahati
ang patayong resolusyon).

Ang pinagmulan at target ay tinukoy ng marami, maraming mga parameter, ngunit y4mscaler ay marami, marami
heuristics built-in upang awtomatikong itakda ang mga ito nang naaangkop. Karamihan sa mga parameter ng pinagmulan ay
kinuha mula sa input stream header. Mga natitirang source at target na parameter na hindi
na tinukoy ng gumagamit ay nahulaan sa isang matino na paraan.

y4mscaler may kasamang mga preset na parameter para sa ilang karaniwang target na stream: DVD, VideoCD
(VCD), SuperVCD (SVCD), nauugnay na mga still image format, at DV.

HALIMBAWA

Upang lumikha ng isang stream na naaangkop para sa paggamit sa isang SVCD:

y4mscaler -O preset=svcd

Upang lumikha ng stream para sa isang VideoCD (isang hindi interlaced na format), mula sa isang DV source (an
interlaced format), inililipat ang input frame na 4 pixels sa kaliwa:

y4mscaler -I ilace=bottom-only -I active=-4+0cc -O preset=vcd

Upang kumuha ng widescreen na NTSC DV source, at i-convert ito sa isang letterboxed stream, na may asul
mga bar sa itaas at ibaba:

y4mscaler -O sar=ntsc -O bg=RGB:0,0,255

Upang kumuha ng widescreen na NTSC DV source, at i-convert ito sa isang "fullscreen" na stream (ibig sabihin, ang
ang mga gilid ay pinutol, tulad ng sa TV):

y4mscaler -O sar=ntsc -O infer=clip

Upang kumuha ng nakasentro, naka-letter na pinagmulan ng NTSC, at i-convert ito sa isang widescreen (16:9) na format
stream para sa DVD, na tinanggal ang mga itim na bar:

y4mscaler -O preset=dvd -O sar=ntsc_wide -O infer=clip

Para kunin ang gitnang 100x100 pixel na tipak ng isang NTSC DV stream, palibutan ito ng 20-pixel
asul na hangganan, at pasabugin iyon hanggang sa isang full-screen na SuperVCD stream:

y4mscaler -I active=140x140+0+0cc -I matte=100x100+0+0cc -I bg=RGB:0,0,255 -O
preset=svcd

Opsyon

Ang unang tatlong opsyon, -v, -V, at -h, ay mga simpleng diretsong opsyon na kukuha
alinman sa walang mga argumento o isang numerong argumento.

-v [0,1,2]
Itakda ang antas ng verbosity.
0 = mga babala at error lamang.
1 = magdagdag din ng mga mensaheng nagbibigay-kaalaman (default).
2 = magdagdag din ng chatty debugging na mensahe.

-V Ipakita ang impormasyon ng bersyon at lumabas.

-h Magpakita ng mensahe ng tulong (buod ng mga opsyon).

Ang -I, -O, at -S na mga opsyon ay bawat isa ay tumatagal ng isang argumento ng form parameter=halaga, alin
tukuyin ang mga parameter para sa input, output, at scaling, ayon sa pagkakabanggit. Ang mga pagpipiliang ito ay maaaring
ginamit nang paulit-ulit upang tukuyin ang maramihang mga parameter. Ang mga pangalan at halaga ng parameter ay hindi
case-sensitive. Ang mga kahulugan ng anyong "parameter=[AAA|BBB|CCC]" ay nangangahulugang isa lamang sa
maaaring piliin ang mga nakalistang keyword na AAA, BBB, o CCC. I-override ang mga nagtagumpay na opsyon
mga nauna.

-I input_parameter
Tukuyin ang mga parameter para sa source/input stream. Ang lahat ng mga argumentong '-I' ay sinusuri sa
pagkakasunud-sunod, at ang mga argumento sa susunod na command-line ay i-override ang mga nauna. Lahat ng '-ako'
ang mga argumento ay sinusuri bago ang anumang '-O' na mga argumento.

aktibo=WxH+X+Yaa
Tukuyin ang aktibong rehiyon ng pinagmulang frame, na naka-scale upang magkasya sa aktibo
rehiyon ng target na frame. Ang default ay ang buong frame. (Ang "WxH" ay maaaring
tinanggal, at ang laki ng rehiyon ay nagde-default sa laki ng source frame.) W at
H ay lapad at taas. Ang X at Y ay ang offset ng anchor point. "aa" ay ang
anchor mode (default: TL); tingnan ang "NOTES ON REGION GEOMETRY" para sa mga detalye.
Halimbawa: aktibo=200x180+30+24cc

matte=WxH+X+Y
Tumukoy ng matte na rehiyon para sa pinagmulang frame. Lahat ng pixel sa labas ng rehiyong ito
ay nakatakda sa pinagmulang kulay ng background. Ang default na matte ay ang buong frame. (Ang
Maaaring alisin ang "WxH", at ang laki ng rehiyon ay nagde-default sa laki ng pinagmulan
frame.) Ang W at H ay lapad at taas. Ang X at Y ay ang offset ng anchor
punto. Ang "aa" ay ang anchor mode (default: TL); tingnan ang "NOTES ON REGION GEOMETRY" para sa
mga detalye.
Halimbawa: matte=200x180+30+24cc

bg=RGB:r,g,b
bg=YCBCR:y,cb,cr
bg=RGBA:r,g,b,a
bg=YCBCRA:y,cb,cr,a
Itakda ang kulay ng background ng pinagmulan. Ang mga pixel sa labas ng matte na rehiyon ng pinagmulan ay
itakda sa kulay na ito. Maaaring tukuyin ng isa ang kulay bilang alinman sa R'G'B' o Y'CbCr triplet.
Halimbawa, ang default na kulay ay itim, na tinukoy bilang "bg=YCBCR:16,128,128" o
"bg=RGB:0,0,0". Itatakda ng mga bersyong 'A' ang alpha (transparency) na halaga ng
kulay. Ang alpha range ay [0,255] para sa RGBA at [16,235] para sa YCBCRA. Ang default
ay ganap na malabo (255 para sa RGBA, 235 para sa YCBCRA).

pamantayan=[NTSC|PAL|SECAM]
Tukuyin ang "karaniwan" ng source stream. Ito ay karaniwang hinuha mula sa
header ng stream.

ilace=[Wala|TOP_FIRST|BOTTOM_FIRST|TOP_ONLY|BOTTOM_ONLY]
Tukuyin ang interlacing na ginamit ng source stream. WALA, TOP_FIRST, at
BOTTOM_FIRST ay tumutugma sa hindi interlaced, top-field-first, at bottom-field-
una. Ang mga halagang ito ay karaniwang hinihinuha mula sa header ng stream; pagtukoy sa kanila
ay i-override ang stream header.
Tinukoy ng TOP_ONLY at BOTTOM_ONLY na ang tuktok o ibabang field lamang ng bawat frame
dapat gamitin; ang kabilang field ay itinapon. Ang mga opsyong ito ay magagamit lamang sa
isang interlaced input, at maging sanhi ng interlaced stream na ituring bilang a
progresibong batis na may kalahating taas. (Ito ay partikular na kapaki-pakinabang sa paglikha
isang VCD mula sa isang buong laki na interlaced input stream.) Ang dalawang espesyal na opsyon na ito ay maaaring
magagamit lamang kapag ang pinagmulan ay isang purong progresibong stream (kumpara sa a
YUV4MPEG2 "mixed-mode" na stream).

chromass=[420JPEG|420MPEG2|420PALDV|444|422|411|mono|444alpha]
Tukuyin ang chroma subsampling mode na ginamit sa source stream. Ang parameter na ito ay
hinuha mula sa header ng stream, kaya ang keyword na ito ay halos hindi dapat gamitin sa a
pagtutukoy ng pinagmulan. Ang tanging kapaki-pakinabang na dahilan upang tukuyin ang keyword na ito ay upang
i-override ang isang variety ng 4:2:0 sa isa pa. Anumang iba pang paggamit ay magdudulot ng pagproseso sa
mabibigo.

sar=N:D
sar=[NTSC|PAL|NTSC_WIDE|PAL_WIDE]
Tukuyin ang sample-aspect-ratio ng source stream. Ang halaga ay maaaring maging o
numeric ratio (gaya ng "10:11") o isa sa mga keyword, na tumutugma sa
Mga value ng CCIR-601 para sa 4:3 o 16:9 na mga display, ayon sa pagkakabanggit. Ang parameter na ito ay karaniwang
hinuha mula sa header ng stream.

-O output_parameter
Tukuyin ang mga parameter para sa patutunguhan/output stream. Lahat ng '-O' na argumento ay
sinusuri sa pagkakasunud-sunod, at sa ibang pagkakataon ang mga argumento sa command-line ay mas maagang i-override
mga. Ang lahat ng '-O' na argumento ay sinusuri pagkatapos ng anumang '-I' na argumento.

laki=WxH
laki=SRC
Itakda ang output/target na laki ng frame, bilang lapad W at taas H sa mga pixel. Gamitin ang
keyword SRC upang tukuyin na ang target na laki ng frame ay dapat tumugma sa pinagmulang frame
laki.

aktibo=WxH+X+Yaa
Tukuyin ang aktibong rehiyon ng target na frame, kung saan ang aktibong rehiyon ng
naka-scale ang source frame. Ang default ay ang buong target na frame. (Ang "WxH" ay maaaring
tinanggal, at ang laki ng rehiyon ay nagde-default sa laki ng target na frame.) W at
H ay lapad at taas. Ang X at Y ay ang offset ng anchor point. "aa" ay ang
anchor mode (default: TL); tingnan ang "NOTES ON REGION GEOMETRY" para sa mga detalye.
Halimbawa: aktibo=200x180+30+24cc

bg=RGB:r,g,b
bg=YCBCR:y,cb,cr
bg=RGBA:r,g,b,a
bg=YCBCRA:y,cb,cr,a
Itakda ang target na kulay ng background. Ang mga pixel sa labas ng aktibong rehiyon ng target ay
itakda sa kulay na ito. Maaaring tukuyin ng isa ang kulay bilang alinman sa R'G'B' o Y'CbCr triplet.
Halimbawa, ang default na kulay ay itim, na tinukoy bilang "bg=YCBCR:16,128,128" o
"bg=RGB:0,0,0". Itatakda ng mga bersyong 'A' ang alpha (transparency) na halaga ng
kulay. Ang alpha range ay [0,255] para sa RGBA at [16,235] para sa YCBCRA. Ang default
ay ganap na malabo (255 para sa RGBA, 235 para sa YCBCRA).

ilace=[Wala|TOP_FIRST|BOTTOM_FIRST]
Tukuyin ang interlacing na ginagamit ng target na stream. WALA, TOP_FIRST, at
BOTTOM_FIRST ay tumutugma sa hindi interlaced, top-field-first, at bottom-field-
una. Ang default kung upang tumugma sa source stream.
Kung ang pinagmulan at target ay parehong interlaced, ngunit may iba't ibang mga mode (ibig sabihin, isa
ay nasa ilalim-una, at ang isa ay nasa itaas-una), pagkatapos y4mscaler ay magko-convert ng isang mode
sa isa pa sa pamamagitan ng pag-drop sa unang source field.

chromass=[420JPEG|420MPEG2|420PALDV|444|422|411|mono|444alpha]
Tukuyin ang chroma subsampling mode na gagamitin sa target na stream. Ang default
ay upang tumugma sa source mode. Tingnan ang "NOTES ON CHROMA MODES AND SUBSAMPLING" para sa higit pa
impormasyon.

sar=N:D
sar=[SRC|NTSC|PAL|NTSC_WIDE|PAL_WIDE]
Tukuyin ang sample-aspect-ratio ng source stream. Ang halaga ay maaaring maging o
numeric ratio (gaya ng "10:11") o isa sa mga keyword, na tumutugma sa
Mga value ng CCIR-601 para sa 4:3 o 16:9 na mga display, ayon sa pagkakabanggit. Ang keyword SRC tumutukoy
na ang target na SAR ay dapat tumugma sa pinagmulan.

sukat=N / A
Xscale=N / A
Yscale=N / A
Itakda ang scaling ratios, bilang isang fraction; halimbawa, sukat=1/2. Ang "scale=" ay nagtatakda ng pareho
X at Y factor nang sabay. Maaaring gamitin ang "Xscale=" at "Yscale=" para itakda ang mga ito
malaya

hinuha=[Pad|CLIP|PRESERVE_X|PRESERVE_Y]
Itakda ang mode na ginamit upang maghinuha ng mga scaling ratio mula sa mga aktibong rehiyon at SAR. Ang
ang mga keyword ay kapwa eksklusibo. Ang default ay PAD.

hinuha=[SIMPLIFY|Eksakto]
Itakda kung ang heuristic sa itaas ay gumagamit ng mga eksaktong ratio, o kung ito ay pinapayagan
bahagyang ayusin ang mga aktibong rehiyon upang pasimplehin ang mga scaling ratio. Ang mga keyword ay
kapwa eksklusibong. Ang default ay SIMPLIFY.

ihanay =[TL|TC|TR|CL|CC|CR|BL|BC|BR]
Itakda ang alignment point sa pagitan ng source at target na aktibong rehiyon. Ang
tinukoy ng mga keyword ang "itaas-kaliwa", "itaas-gitna", "itaas-kanan", atbp. Ang tinukoy na sulok
o punto mula sa pinagmulang rehiyon ay imamapa sa parehong lugar sa target
rehiyon; at pag-crop o padding na inilalapat sa mga aktibong rehiyon ay
pangalagaan ang pagmamapa na ito. Ang default ay CC, para sa "center-center", ibig sabihin, ang pinagmulan
at ang mga target na rehiyon ay kapwa nakasentro. Ang mga keyword ay kapwa eksklusibo.
Ang default ay CC. Tingnan ang "NOTES ON SOURCE AND TARGET ALGNMENT" para sa mga detalye.

preset=[VCD|CVD|CDLS|DVD|DVD_WIDE|DV|DV_WIDE|
SVCD_STILL_HI|SVCD_STILL_LO|VCD_STILL_HI|VCD_STILL_LO|
ATSC_720P|ATSC_1080I|ATSC_1080P]
Gumamit ng mga preset na target na parameter para sa ilang karaniwang mga format ng output. Indibidwal
Maaaring ma-override ang mga parameter sa pamamagitan ng pagsunod sa higit pang mga setting ng "-O". Ang mga keyword na ito
ay kapwa eksklusibo. Para sa mga detalye ng kung anong mga setting ang mga preset na keyword na ito
magpahiwatig, tingnan ang "NOTES ON TARGET PRESET".

VCD - 352-wide VideoCD, progresibo

CVD - 352-wide (full-height) ChinaVideoDisc

CDLS - 480-wide SuperVCD

DVD - 720-wide DVD

DVD_WIDE - 720-wide DVD, anamorphic pixels

DV - 720-wide DV (bottom-field-first, 4:1:1)

DV_WIDE - 720-wide DV, anamorphic pixels

SVCD_STILL_HI - high-resolution na SVCD na imahe pa rin

SVCD_STILL_LO - SVCD na may mababang resolution na imahe

VCD_STILL_HI - high-resolution na VCD still image

VCD_STILL_LO - SVCD na may mababang resolution na imahe

ATSC_720P - ATSC 720p (progresibong HDTV)

ATSC_1080I - ATSC 1080i (interlaced HDTV)

ATSC_1080P - ATSC 1080p (HDTV)

-S scaling_parameter
Tukuyin ang mga parameter para sa scaling engine. Lahat ng '-S' na argumento ay sinusuri sa
pagkakasunud-sunod, at ang mga argumento sa susunod na command-line ay i-override ang mga nauna.

mode=MONO
Humiling ng monochrome scaling. Ang pinagmulan ay itinuturing bilang monochrome at ang chroma nito
hindi pinapansin ang mga channel. Ang mga chroma channel ng output stream ay ise-zero sa
magbunga ng grayscale na output.

mode=LINESWITCH
Humiling ng pagpapalit ng linya. Epektibo, ang itaas at ibabang mga patlang sa loob ng bawat frame
ay ipapalit. Maaaring makatulong ito sa mga maling nabuong stream na nagulo
spatial order. Ang pagpipiliang ito ay epektibo lamang sa mga interlaced na stream.

scaler=scaler-pangalan
Gumamit ng partikular na scaling engine. Ang mga magagamit na makina ay:
'default' - Ang Generic Scaler ni Matto (ang default)

opsyon=scaler-opsyon
Tumukoy ng opsyon para sa napiling scaling engine. Para makita lahat ng available
mga opsyon, gamitin ang "option=help".

Para sa default na makina, ang magagamit scaler-opsyons piliin ang filter na kernel:

kahon - filter ng kahon

pahaba - linear interpolation

parisukat - quadratic interpolation

kubiko - cubic interpolation, Mitchell-Netravali spline

cubicCR - cubic interpolation, Catmull-Rom spline

kubikoB - cubic interpolation, B-spline

kubikoK4 - Mga susi sa ika-4 na order cubic

dahil:N - sinc na may Lanczos window, N cycle

Upang pumili ng mga kernel para sa x at y scaling direksyon nang independyente, gumamit ng dalawang kernel
mga pangalan na pinaghihiwalay ng kuwit, hal option=box,quadratic.

dahil:N ay magbibigay ng pinakamahusay na kalidad ng mga resulta (hindi bababa sa aliasing), ngunit ito ang pinakamabagal.
Ang kalidad ay nagpapabuti sa mas malalaking halaga ng N, pati na rin ang oras ng pagproseso. kubiko is
karaniwang itinuturing sa mundo ng graphics bilang ang 3rd-order cubic spline na may
pinakamahusay na trade-off sa pagitan ng smoothing at aliasing. kahon nagbubunga ng pinakamasamang kalidad
mga resulta (karamihan sa pag-alyas), ngunit ito ang pinakamabilis. Ang default na kernel ay kubikoK4, Na
ay may mas patag na passband at mas matalas na cutoff kaysa kubiko. (Ito ay nangangailangan ng pareho
kapangyarihan ng computational bilang dahil:4, ngunit gumagawa ng mas kaunting ringing artifact.)

NOTA ON TARGET MGA PRESETS

Ang sumusunod na talahanayan ay nagdedetalye ng mga setting na ibinigay ng iba't ibang target na "preset="
mga keyword. Kapag binigyan ng dalawang halaga ang pangunahin ay para sa mga stream ng NTSC; ang halaga sa
Ang {braces} ay para sa mga PAL stream. Kung ang halaga ng interlace ay hindi tinukoy, ito ay minana mula sa
pinagmulan, kung hindi, kinakailangan ang ipinahiwatig na target na interlacing.

Preset na Sukat ng Frame Interlace SAR Subsampling
-------------------------------------------------- ---------------------
VCD 352x240{288} none 10:11{59:54} 4:2:0-JPEG
CVD 352x480{576} --- 20:11{59:27} 4:2:0-MPEG2
SVCD 480x480{576} --- 15:11{59:36} 4:2:0-MPEG2
DVD 720x480{576} --- 10:11{59:54} 4:2:0-MPEG2
DVD_WIDE 720x480{576} --- 40:33{118:81} 4:2:0-MPEG2
DV 720x480{576} bottom-first 10:11{59:54} 4:1:1
DV_WIDE 720x480{576} bottom-first 40:33{118:81} 4:1:1
SVCD_STILL_HI 704x480{576} none 10:11{59:54} 4:2:0-MPEG2
SVCD_STILL_LO 480x480{576} none 15:11{59:36} 4:2:0-MPEG2
VCD_STILL_HI 704x480{576} none 10:11{59:54} 4:2:0-JPEG
VCD_STILL_LO 352x240{288} none 10:11{59:54} 4:2:0-JPEG
ATSC_720p 1280x720 none 1:1 4:2:0-MPEG2
ATSC_1080i 1920x1080 (required) 1:1 4:2:0-MPEG2
ATSC_1080p 1920x1080 none 1:1 4:2:0-MPEG2

NOTA ON REHIYON HEOMETRI

Tinukoy ang mga active at matte na rehiyon gamit ang isang geometry string ng form na "WxH+X+Yaa".
Tinutukoy ng bahaging "WxH" ang laki ng rehiyon, bilang isang Lapad at Taas sa mga pixel. (Sa
ilang mga kaso, ang "WxH" ay maaaring tanggalin, at ang laki ng rehiyon ay nagde-default sa buong frame
laki.) Tinutukoy ng "+X+Y" ang posisyon ng rehiyon, bilang isang offset na nauugnay sa
anchor point na tinukoy ng "aa".

Ang "aa" code ay maaaring isa sa TL, TC, TR, CL, CC, CR, BL, BC, O BR. Ang mga ito ay kumakatawan sa "top-
kaliwa", "top-center", ..., "bottom-center", "bottom-right". Ang mga code na ito ay hindi case-
sensitibo.

Tinutukoy ng "+X+Y" ang offset ng anchor point ng rehiyon mula sa anchor ng frame
punto. Halimbawa, ang ibig sabihin ng "+20+30TL" ay ang kaliwang sulok sa itaas ng rehiyon
offset 20 pixels sa kanan at 30 pixels pababa mula sa itaas na kaliwang sulok ng frame.

Ang mga halaga ng offset ay maaari ding negatibo. Halimbawa, "-4+0CC" ay nangangahulugan na ang sentro
(vertical at horizontal) ng rehiyon ay na-offset ng 4 na pixel sa kaliwa ng gitna ng
ang kwadro.

Ang default na anchoring point para sa mga geometry string ay TL, ibig sabihin, ang kaliwang sulok sa itaas.

NOTA ON SOURCE AT TARGET ALIGNMENT

Kadalasan, hindi eksaktong magkatugma ang pinagmulan at target na aktibong rehiyon. Nangyayari ito kapag,
gamit ang ibinigay o kinakalkula na mga scaling ratio, ang pinagmulang rehiyon ay nagsusukat sa ibang laki
o hugis kaysa sa target na rehiyon. Sa kasong ito, ang pinagmulan at target na mga rehiyon ay magkapareho
pinutol, upang ang bahagi lamang ng pinagmumulan na akma ay mai-scale sa target.

Bago ang anumang clipping o padding, ang pinagmulan at target na mga rehiyon ay nakahanay upang ang
tumukoy ang mga puntong tinukoy sa pamamagitan ng parameter na "align=aa". Ang "aa" code ay tumutukoy sa isang anchor
punto tulad ng inilarawan sa itaas.

Halimbawa, tinukoy ng "align=BC" na dapat makuha ng bottom-center ng pinagmulang rehiyon
nakamapa sa ibabang gitna ng target na rehiyon. Sa madaling salita, gagawin ng pinagmulang rehiyon
pahalang na nakasentro at patayong nakahanay sa ibaba ng target na rehiyon bago
clipping:

---------------- pinagmulan
|abcdefghijklmn|
---|opqrstuvwxyz01|--- target ----------------
| |234567890ABCDE| | |234567890ABCDE|
| |FGHIJKLMNOPQRS| | |FGHIJKLMNOPQRS|
| |TUVWXYZabcdefg| | |TUVWXYZabcdefg|
---------------------- ----------------
Bago ang Mutually Clipped

Kung sa halip ay "align=TR" ang nakasentro, ang pinagmulan ay i-clip sa ibang lugar, at
na-scale sa ibang rehiyon ng target na frame:

---------------------- ----------------
| |abcdefghijklmn| |abcdefghijklmn|
| |opqrstuvwxyz01| |opqrstuvwxyz01|
| |234567890ABCDE| |234567890ABCDE|
------|FGHIJKLMNOPQRS| ----------------
target |TUVWXYZabcdefg| pinagmulan
----------------
Bago ang Mutually Clipped

Ang default na alignment mode ay "CC", ibig sabihin, ang pinagmulan at target ay kapwa nakasentro.

NOTA ON SCALE KATOTOHANAN INFERENSIYA

Kung ang X at Y scaling factor ay hindi tahasang ibinigay, y4mscaler ihihinuha ang
salik mula sa pinagmulan at target na aktibong rehiyon at mga sample na aspect ratio (SAR's).

Kung ang mga aktibong rehiyon ay hindi tugma sa hugis (ibinigay sa SAR), ang pinagmulan at
ang mga target na rehiyon ay i-clip o padded ayon sa isa sa apat na patakaran. Ang patakaran ay
pinili gamit ang parameter na "infer=" at isa sa mga keyword Pad, CLIP, PRESERVE_X, O
PRESERVE_Y. (Ang default ay Pad.)

Pad
Pumili ng mga salik sa pag-scale na magpapatibay sa pinagmulan, ngunit tiyaking ang lahat ng pinagmulan
Ang nilalaman ng imahe ay napupunta sa target.

CLIP
Pumili ng mga scaling factor na mag-clip sa source, ngunit pupunuin ang target
rehiyon hangga't maaari.

PRESERVE_X
Pumili ng mga scaling factor na nagpapanatili ng kasing dami ng pahalang na pinagmulang content
maaari.

PRESERVE_Y
Pumili ng mga salik sa pag-scale na nagpapanatili ng kasing dami ng nilalaman ng vertical na pinagmulan
maaari.

Ang patakaran ay higit na apektado ng isang pagpipilian ng dalawang iba pang mga keyword, SIMPLIFY, O Eksakto.
(Ang default ay SIMPLIFY.)

Eksakto
Kalkulahin ang eksaktong scaling factor.

SIMPLIFY
Ayusin ang mga aktibong rehiyon at scaling factor (sa loob ng 10% o higit pa), para pasimplehin ang
ratios hangga't maaari. (Halimbawa, bahagyang i-crop o pad upang makamit ang isang ratio
ng 2/1 sa halip na 45/22.)

NOTA ON CHROME mode AT SUBSAMPLING

y4mscaler maaaring mag-convert ng mga stream mula sa isang chroma subsampling mode patungo sa isa pa. ganyan
ang mga conversion ay palaging lossy na operasyon, kahit na ang kabuuang frame ay sumasailalim sa 1/1
scaling.

y4mscaler ay maghihinuha ng subsampling mode ng source mula sa mga tag sa input stream header.
Susubukan ng mga target na preset ("preset=XXX") na itakda ang target na subsampling mode
nararapat. Kung hindi, bilang default, ang target na subsampling mode ay tutugma sa pinagmulan.
Ang isa ay maaaring tahasang itakda ang subsampling mode para sa pinagmulan at/o ang target sa pamamagitan ng paggamit ng
"chromass=" parameter.

y4mscaler ay may kakayahang magbasa at magsulat ng mga stream sa 4:4:4, 4:2:2, 4:1:1, at 4:2:0
(lahat ng tatlong uri) mga mode ng subsampling. Ang unang tatlo, gayunpaman, ay medyo bago
karagdagan sa pamantayan ng YUV4MPEG2, at maraming MJPEGtools ang mabibigo na iproseso ang mga ito
tama, kung sabagay. Ang smil2yuv at raw2yuv ay maaaring gumawa ng native na 4:1:1 stream mula sa NTSC DV
video, na maaaring ma-convert sa 4:2:0 ng y4mscaler bago ang karagdagang pagproseso ng
iba pang mga tool.

Kung ang pinagmulan ay mayroong alpha-channel (ibig sabihin, 444ALPHA mode) at ang target ay wala, ang alpha
itatapon na lang ang channel. Sa kabilang banda, kung ang target ay may alpha-channel
ngunit ang pinagmulan ay hindi, isang pare-parehong alpha-channel ay gagawin gamit ang alpha-halaga ng
kulay ng background ng target (tulad ng itinakda ng "-O bg="). Ang default ay ganap na malabo.

Katulad nito, kung ang target ay may mga chroma channel ngunit ang pinagmulan ay wala (ibig sabihin, isang luma-only
MONO stream), pagkatapos ay ang mga chroma channel sa output ay itatakda ayon sa
kulay ng background.

NOTA ON ANOMALOUS INTERLACE PAG-AARAL

Nagbibigay-daan ang format na YUV4MPEG2 para sa mga stream na "mixed-mode interlacing", na maaaring naglalaman ng
pinaghalong progresibo at interlaced na mga frame. Ang bawat frame ay na-tag bilang pansamantala
interlaced o progressive, at vertically-subsampled na mga frame (4:2:0 formats) ay higit pa
na-tag bilang spatially interlaced o hindi. Sa kasamaang palad, ito ay nagbibigay-daan para sa posibilidad ng
anomalya mga frame, na nangyayaring pansamantalang magkakaugnay (mga field na na-sample sa iba't ibang
beses) ngunit spatially progressive (subsampling na isinagawa sa buong frame), o vice-
kabaligtaran. Ang tanging makatwirang bagay na dapat gawin sa gayong maanomalyang mga frame ay ang patayo-
upsample ang chroma, mahalagang maalis ang problema sa lalong madaling panahon.

y4mscaler ipoproseso lamang ang naturang mga frame kung ang target na format ng output ay hindi patayo-
subsampled (hal. 4:4:4, 4:2:2, atbp.) at walang ibang vertical na pagproseso ang kinakailangan.
Kung hindi man y4mscaler magpiyansa sa pagpoproseso sa midstream kapag nakatagpo ito ng maanomalyang
kuwadro. Kung mayroong anumang posibilidad na makatagpo ng ganoong error, y4mscaler magpapalimbag ng a
babala kapag nagsimula ang pagproseso.

EXIT STATUS

0 Matagumpay na pagpapatupad ng programa.

1 Error sa paggamit, syntax, o pagpapatakbo.

Gamitin ang y4mscaler online gamit ang mga serbisyo ng onworks.net