@@ -861,19 +861,14 @@ written. They can be turned off with
861
861
.TP 5
862
862
.Oa \-\- resize width x height
863
863
'
864
- Resize the output GIF to
865
- .IR width x height .
866
- Either
864
+ Resize the output GIF to the given
865
+ .IR width " and " height .
866
+ If
867
867
.I width
868
868
or
869
869
.I height
870
- may be an underscore \(oq _\(cq . If the argument is
871
- .IR width x_,
872
- then the output GIF is scaled to
873
- .I width
874
- pixels wide without changing its aspect ratio. An analogous operation is
875
- performed for
876
- .RI _x height .
870
+ is an underscore \(oq _\(cq , that dimension is chosen so that the
871
+ aspect ratio remains unchanged.
877
872
Resizing happens after all input frames have been combined and before
878
873
optimization. Resizing uses logical screen dimensions; if
879
874
the input stream has an unusual logical screen (many GIF displayers ignore
@@ -892,40 +887,43 @@ uses image dimensions instead. See also
892
887
.TP
893
888
.Oa \-\- resize \- height height
894
889
'
895
- Like
890
+ Resize to a given width or height, preserving aspect ratio. Equivalent to
896
891
.Oa \-\- resize width x_
897
- and
898
- .Oa \-\- resize " " _x height
899
- respectively.
892
+ or
893
+ .Oa \-\- resize " " _x height .
900
894
'
901
895
.Sp
902
896
.TP
903
897
.Oa \-\- resize \- fit width x height
898
+ .TP
899
+ .Oa \-\- resize \- touch width x height
904
900
'
905
- Like
906
- .Op \-\- resize ,
907
- but resizes the output GIF to fit
908
- .I within
909
- a rectangle with dimensions
901
+ Resize the output GIF to fit within a rectangle with dimensions
910
902
.IR width x height .
911
- The GIF's aspect ratio remains unchanged. No resize is performed if the GIF already
912
- fits within the given rectangle. Either
903
+ The aspect ratio remains unchanged. The
904
+ .Op \-\- resize \- fit
905
+ option only shrinks the image\(em no resize is performed if the GIF already
906
+ fits within the rectangle. Either
913
907
.I width
914
908
or
915
909
.I height
916
- may be an underscore \(oq _\(cq , which is treated as infinity .
910
+ may be an underscore \(oq _\(cq , which leaves that dimension unconstrained .
917
911
'
918
912
.Sp
919
913
.TP
920
914
.Oa \-\- resize \- fit \- width width
921
915
.TP
922
916
.Oa \-\- resize \- fit \- height height
917
+ .TP
918
+ .Oa \-\- resize \- touch \- width width
919
+ .TP
920
+ .Oa \-\- resize \- touch \- height height
923
921
'
924
922
Like
925
- .Oa \-\- resize \- fit width x_
923
+ .Oa \-\- resize \- fit
926
924
and
927
- .Oa \-\- resize \- fit " " _x height
928
- respectively .
925
+ .Op \-\- resize \- touch ,
926
+ but constrains only one dimension .
929
927
'
930
928
.Sp
931
929
.TP
@@ -953,8 +951,8 @@ currently \(oqmix\(cq.
953
951
.Sp
954
952
.PP
955
953
Details: The resize methods differ most when shrinking images. The
956
- \(oq sample\(cq method is a point sampler. Each pixel position in the
957
- output image maps to exactly one pixel position in the input, so when
954
+ \(oq sample\(cq method is a point sampler: each pixel position in the
955
+ output image maps to exactly one pixel position in the input. When
958
956
shrinking, full rows and columns from the input are dropped. The other
959
957
methods use all input pixels, which generally produces better-looking
960
958
images. The \(oq box\(cq method, a box sampler, is faster than the more
@@ -963,10 +961,10 @@ be anomalies when shrinking images by a small amount in one dimension.
963
961
(Some output pixels will correspond to exactly 1 input row or column,
964
962
while others will correspond to exactly 2 input rows or columns.) The
965
963
\(oq mix\(cq method is a full bilinear interpolator. This is slower and
966
- produces somewhat blurrier results, but avoids such anomalies.
964
+ produces somewhat blurrier results, but avoids anomalies.
967
965
.Sp
968
966
.PP
969
- Gifsicle also supports several complex resamplers, including
967
+ Gifsicle also supports more complex resamplers, including
970
968
Catmull-Rom cubic resampling (\(oq catrom\(cq ), the Mitchell-Netravali
971
969
filter (\(oq mitchell\(cq ), a 2-lobed Lanczos filter
972
970
(\(oq lanczos2\(cq ), and a 3-lobed Lanczos filter (\(oq lanczos3\(cq ).
0 commit comments