Crop - Revision history

Reel.Deal: add link to avs+ documentation

2022-09-18T02:54:20Z

add link to avs+ documentation

Admin at 18:51, 26 March 2016

2016-03-26T18:51:52Z

Admin at 18:51, 26 March 2016

2016-03-26T18:51:41Z

Admin: /* Crop restrictions */

2016-03-26T18:49:06Z

‎Crop restrictions

Admin: /* Syntax and Parameters */

2016-03-26T18:28:07Z

‎Syntax and Parameters

Admin at 18:25, 26 March 2016

2016-03-26T18:25:12Z

Admin at 18:24, 26 March 2016

2016-03-26T18:24:55Z

Admin at 18:23, 26 March 2016

2016-03-26T18:23:59Z

Admin: wikipedia is confusing at best - they refer to aspect ratio as framesize in that quote (in that sense it is correct)

2016-03-26T18:23:42Z

wikipedia is confusing at best - they refer to aspect ratio as framesize in that quote (in that sense it is correct)

Raffriff42: tweak wording

2016-02-01T01:34:15Z

tweak wording

← Older revision		Revision as of 02:54, 18 September 2022
Line 1:		Line 1:
		+	<div {{BlueBox2\|40\|0\|3px solid purple}} >
		+	{{AvsPlusFullname}}<br>
		+	Up-to-date documentation: [https://avisynthplus.readthedocs.io/en/latest/avisynthdoc/corefilters/crop.html https://avisynthplus.readthedocs.io]
		+	</div>
		+
		+
	''Cropping'' refers to the removal of the outer parts of an image to improve framing, changing the framesize (also called image or storage aspect ratio). See Wikipedia: [[Wikipedia:Cropping_(image)\|Cropping]].		''Cropping'' refers to the removal of the outer parts of an image to improve framing, changing the framesize (also called image or storage aspect ratio). See Wikipedia: [[Wikipedia:Cropping_(image)\|Cropping]].
	__TOC__		__TOC__

@@ Line 113: / Line 113: @@
 |-
 | v2.53
-| Added algin option.
+| Added align option.
 |}
 [[Category:Internal filters]]
 [[Category:Borders_and_Cropping]]

@@ Line 109: / Line 109: @@
 </div>
 [[Category:Internal filters]]
 [[Category:Borders_and_Cropping]]

@@ Line 69: / Line 69: @@
 | mod-2
 | mod-4
 |-
 |}
@@ Line 76: / Line 91: @@
 :In summary: ''For cropping off hard artifacts like VHS head noise or letterbox borders always use '''''Crop'''''. For extracting a portion of an image and to maintain accurate edge resampling, use the '''''Resize''''' cropping parameters.'' ([http://forum.doom9.org/showthread.php?s=&threadid=91630 Doom9 thread])
 </div>
 == Examples ==

@@ Line 14: / Line 14: @@
 :{{Par2|width, height|int|}}
-:{{Par2|-right, -bottom|int|}}
+:{{Par2|right, bottom|int|}}
 <div {{ListItemContinue|4}} >
 The third and fourth arguments have different names or ''aliases'', depending on their value:
@@ Line 41: / Line 41: @@
 </div>
 == Crop restrictions ==

@@ Line 1: / Line 1: @@
-''Cropping'' refers to the removal of the outer parts of an image to improve framing, hence changing the framesize (also called image or storage aspect ratio). See Wikipedia: [[Wikipedia:Cropping_(image)|Cropping]].
+''Cropping'' refers to the removal of the outer parts of an image to improve framing, changing the framesize (also called image or storage aspect ratio). See Wikipedia: [[Wikipedia:Cropping_(image)|Cropping]].
 __TOC__
 == Syntax and Parameters ==

@@ Line 2: / Line 2: @@
 __TOC__
 == Syntax and Parameters ==
-<div style="max-width:48em" >
+<div style="max-width:50em" >
 {{Func3Def
 |Crop(clip ''clip'', int ''left'', int ''top'', int ''width'', int ''height'' [, bool ''align'' ] )
@@ Line 20: / Line 20: @@
 *If &lt;= zero, they set the cropping of the {{FuncArg|right}} and {{FuncArg|bottom}} edges respectively.
 Note, there are certain limits:
-* {{FuncArg|width}} cannot be &gt;= ({{FuncArg|clip}}.[[Clip_properties|Width]] - {{FuncArg|left}})
+* {{FuncArg|clip}}.[[Clip_properties|Width]] must be &gt;= ({{FuncArg|left}} + {{FuncArg|width}})
-* {{FuncArg|height}} cannot be &gt;= ({{FuncArg|clip}}.[[Clip_properties|Height]] - {{FuncArg|top}})
+* {{FuncArg|clip}}.[[Clip_properties|Width]] must be &gt;&nbsp; ({{FuncArg|left}} + {{FuncArg|right}})
-<div {{ListItemContinue}} >
+* {{FuncArg|clip}}.[[Clip_properties|Height]] must be &gt;= ({{FuncArg|top}} + {{FuncArg|height}})
-...this would enlarge or "un-crop" the clip, which is not allowed.
+* {{FuncArg|clip}}.[[Clip_properties|Height]] must be &gt;&nbsp; ({{FuncArg|top}} + {{FuncArg|bottom}})
-</div>
+&nbsp;...otherwise it would enlarge ("un-crop") the clip, or reduce width or height to 0,
-* '''-'''{{FuncArg|right}} cannot be &gt;= ({{FuncArg|clip}}.[[Clip_properties|Width]] - {{FuncArg|left}})
+which is not allowed.
-* '''-'''{{FuncArg|bottom}} cannot be &gt;= ({{FuncArg|clip}}.[[Clip_properties|Height]] - {{FuncArg|top}})
-<div {{ListItemContinue}} >
-...this would reduce clip width or height to 0, which is not allowed.
-</div>
 *See [[#Crop restrictions|crop modulo restrictions]] below.
 </div>
@@ Line 35: / Line 31: @@
 :{{Par2|count|int|}}
 ::The alternative '''CropBottom''' syntax was created to crop garbage off the bottom of a clip captured from [[Wikipedia:VHS|VHS]] tape. It removes {{FuncArg|count}} lines from the bottom of the frame.
-::*See [[#Crop restrictions|crop restrictions]] below.
+::*See [[#Crop restrictions|crop modulo restrictions]] below.
 :{{Par2|align|bool|false}}