MessageClip: Difference between revisions

From Avisynth wiki
Jump to navigationJump to search
Raffriff42 (talk | contribs)
m line break
add link to avs+ documentation
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
'''MessageClip''' produces a clip containing a text message. The font face is "Arial". The font size is between 24 points and 9 points - chosen to fit, if possible, in the width by height clip. Used internally for error reporting.
<div style="max-width:62em" >
<div {{BlueBox2|40|0|3px solid purple}} >
{{AvsPlusFullname}}<br>
Up-to-date documentation: [https://avisynthplus.readthedocs.io/en/latest/avisynthdoc/corefilters/message.html https://avisynthplus.readthedocs.io]
</div>
 
 
'''MessageClip''' produces a clip containing a text message. Used internally for error reporting.
 
The font face is "Arial". The font size is between 24 points and 9 points - chosen to fit, if possible, in the width by height clip. The pixeltype is RGB32.
</div>




== Syntax and Parameters ==
== Syntax and Parameters ==
{{Template:FuncDef|MessageClip(string ''message'' [, int ''width'', int ''height'', bool ''shrink'', int ''text_color'', int ''halo_color'', int ''bg_color'' ] )}}
<div style="max-width:62em" >
{{FuncDef
|MessageClip(string ''message'' [, int ''width'', int ''height'', bool ''shrink'', int ''text_color'', int ''halo_color'', int ''bg_color'' ] )
}}


:{{Par2|message|string|}}
:{{Par2|message|string|}}
:: The message to be displayed. Required.  
:: The message to be displayed. Required.  


:{{Par2|width|int|0}}
:{{Par2|width|int|-1}}
:{{Par2|height|int|0}}
:{{Par2|height|int|-1}}
:: Width and height of the resulting clip. By default, the clip grows to the size required to display the message.  
:: Width and height of the resulting clip. By default, the width and height are chosen such that it can display the message with size 24 points.


:{{Par2|shrink|bool|false}}
:{{Par2|shrink|bool|false}}
Line 20: Line 33:
:{{Par2|bg_color|int|[[Preset colors|color_black]]}}
:{{Par2|bg_color|int|[[Preset colors|color_black]]}}
::Colors for font fill, outline and background respectively. Default white, black, black.  
::Colors for font fill, outline and background respectively. Default white, black, black.  
</div>




== Examples ==
== Examples ==
 
<div style="max-width:62em" >
<div {{BoxWidthIndent|46|0}} >
<div {{BoxWidthIndent|46|0}} >
  MessageClip([[Internal_functions#VersionString|VersionString]])
  MessageClip([[Internal_functions#VersionString|VersionString]])
Line 52: Line 66:
</div>
</div>
:[[File:MessageClip3-red.png]]
:[[File:MessageClip3-red.png]]
</div>




[[Category:Internal filters]]
[[Category:Internal filters]]
[[Category:Debugging/Diagnostic filters]]
[[Category:Debugging/Diagnostic filters]]

Latest revision as of 07:21, 18 September 2022

AviSynth+
Up-to-date documentation: https://avisynthplus.readthedocs.io


MessageClip produces a clip containing a text message. Used internally for error reporting.

The font face is "Arial". The font size is between 24 points and 9 points - chosen to fit, if possible, in the width by height clip. The pixeltype is RGB32.


Syntax and Parameters

MessageClip(string message [, int width, int height, bool shrink, int text_color, int halo_color, int bg_color ] )

string  message =
The message to be displayed. Required.
int  width = -1
int  height = -1
Width and height of the resulting clip. By default, the width and height are chosen such that it can display the message with size 24 points.
bool  shrink = false
If true, and width and/or Height are specified, the clip resolution is reduced to a smaller size, if possible, to fit the text.
If false (the default), the text will appear at the top-center of the video frame.
int  text_color = color_white
int  halo_color = color_black
int  bg_color = color_black
Colors for font fill, outline and background respectively. Default white, black, black.


Examples

MessageClip(VersionString)


 MessageClip(VersionString, width=240) 


MessageClip(VersionString, bg_color=$ff0000) 


 MessageClip(VersionString, bg_color=$ff0000, height=80)


 MessageClip(VersionString, bg_color=$ff0000, height=80, shrink=true)