Crop - Revision history

Reel.Deal: add link to avs+ documentation

2022-09-18T02:54:20Z

add link to avs+ documentation

← Older revision		Revision as of 04: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__

Admin at 18:51, 26 March 2016

2016-03-26T18:51:52Z

← Older revision		Revision as of 20:51, 26 March 2016
Line 113:		Line 113:
	\|-		\|-
	\| v2.53		\| v2.53
	\| Added ~~algin~~ option.		\| Added align option.
	\|}		\|}

	[[Category:Internal filters]]		[[Category:Internal filters]]
	[[Category:Borders_and_Cropping]]		[[Category:Borders_and_Cropping]]

Admin at 18:51, 26 March 2016

2016-03-26T18:51:41Z

← Older revision		Revision as of 20:51, 26 March 2016
Line 109:		Line 109:
	</div>		</div>

			== Changes ==
			{\| border="1"
			\|-
			\| v2.53
			\| Added algin option.
			\|}

	[[Category:Internal filters]]		[[Category:Internal filters]]
	[[Category:Borders_and_Cropping]]		[[Category:Borders_and_Cropping]]

Admin: /* Crop restrictions */

2016-03-26T18:49:06Z

Crop restrictions

@@ 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 ==

Admin: /* Syntax and Parameters */

2016-03-26T18:28:07Z

Syntax and Parameters

← Older revision		Revision as of 20:28, 26 March 2016
Line 14:		Line 14:

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

	</div>		</div>


	== Crop restrictions ==		== Crop restrictions ==

Admin at 18:25, 26 March 2016

2016-03-26T18:25:12Z

← Older revision		Revision as of 20:25, 26 March 2016
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__		__TOC__
	== Syntax and Parameters ==		== Syntax and Parameters ==

Admin at 18:24, 26 March 2016

2016-03-26T18:24:55Z

← Older revision		Revision as of 20:24, 26 March 2016
Line 1:		Line 1:
	''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, hence changing the framesize (also called image or storage aspect ratio). See Wikipedia: [[Wikipedia:Cropping_(image)\|Cropping]].
	__TOC__		__TOC__
	== Syntax and Parameters ==		== Syntax and Parameters ==

Admin at 18:23, 26 March 2016

2016-03-26T18:23:59Z

← Older revision		Revision as of 20:23, 26 March 2016
Line 1:		Line 1:
	''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__
	== Syntax and Parameters ==		== Syntax and Parameters ==

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)

← Older revision		Revision as of 20:23, 26 March 2016
Line 1:		Line 1:
	''Cropping'' refers to the removal of the outer parts of an image to improve framing or ~~change~~ 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__
	== Syntax and Parameters ==		== Syntax and Parameters ==

Raffriff42: tweak wording

2016-02-01T01:34:15Z

tweak wording

← Older revision		Revision as of 03:34, 1 February 2016
Line 2:		Line 2:
	__TOC__		__TOC__
	== Syntax and Parameters ==		== Syntax and Parameters ==
	<div style="max-width:~~48em~~" >		<div style="max-width:50em" >
	{{Func3Def		{{Func3Def
	\|Crop(clip ''clip'', int ''left'', int ''top'', int ''width'', int ''height'' [, bool ''align'' ] )		\|Crop(clip ''clip'', int ''left'', int ''top'', int ''width'', int ''height'' [, bool ''align'' ] )
Line 20:		Line 20:
	*If <= zero, they set the cropping of the {{FuncArg\|right}} and {{FuncArg\|bottom}} edges respectively.		*If <= zero, they set the cropping of the {{FuncArg\|right}} and {{FuncArg\|bottom}} edges respectively.
	Note, there are certain limits:		Note, there are certain limits:
	* ~~{{FuncArg\|width}} cannot be >= (~~{{FuncArg\|clip}}.[[Clip_properties\|Width]] - {{FuncArg\|left}})		* {{FuncArg\|clip}}.[[Clip_properties\|Width]] must be >= ({{FuncArg\|left}} + {{FuncArg\|width}})
	* {{FuncArg\|~~height~~}} ~~cannot be >= (~~{{FuncArg\|clip}}.[[Clip_properties\|~~Height~~]] - {{FuncArg\|~~top~~}})		* {{FuncArg\|clip}}.[[Clip_properties\|Width]] must be >  ({{FuncArg\|left}} + {{FuncArg\|right}})
	~~<div~~ {{~~ListItemContinue~~}} >		* {{FuncArg\|clip}}.[[Clip_properties\|Height]] must be >= ({{FuncArg\|top}} + {{FuncArg\|height}})
	~~...this would enlarge or "un-crop" the clip, which is not allowed.~~		* {{FuncArg\|clip}}.[[Clip_properties\|Height]] must be >  ({{FuncArg\|top}} + {{FuncArg\|bottom}})
	~~</div>~~		...otherwise it would enlarge ("un-crop") the clip, or reduce width or height to 0,
	* ~~'''-'''~~{{FuncArg\|~~right~~}} ~~cannot~~ be >= ({{FuncArg\|~~clip~~}}~~.[[Clip_properties\|Width]] -~~ {{FuncArg\|~~left~~}})		which is not allowed.
	* ~~'''-'''{{FuncArg\|bottom}} cannot be >= (~~{{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.		*See [[#Crop restrictions\|crop modulo restrictions]] below.
	</div>		</div>
Line 35:		Line 31:
	:{{Par2\|count\|int\|}}		:{{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.		::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}}		:{{Par2\|align\|bool\|false}}