DoesItReallyMatter: Misc.

2019-06-02T04:26:34Z

Misc.

← Older revision		Revision as of 04:26, 2 June 2019
Line 51:		Line 51:
	\|value=integer		\|value=integer
	\|select={ 0, 1, 2, 4, 8, 5, 6, 9, 10 }		\|select={ 0, 1, 2, 4, 8, 5, 6, 9, 10 }
	\|description=Subpicture position<sup~~><small~~>('''[[#appendix_dvbsub-position\|key]]''')~~</small>~~</sup>		\|description=Subpicture position<sup>('''[[#appendix_dvbsub-position\|key]]''')</sup>
	}}		}}
	{{Option		{{Option
Line 82:		Line 82:

	== Appendix ==		== Appendix ==
	<~~span id~~="~~appendix_dvbsub-position~~"~~></span~~>		<div class="plainlist">
	~~'''For the option~~ [[#dvbsub-position\|--dvbsub-position]]~~:'''~~		*^ [[#dvbsub-position\|--dvbsub-position]]<span id="appendix_dvbsub-position"></span>
			</div>
	{{Alignment mapping}}		{{Alignment mapping}}

Line 89:		Line 90:
	* {{VLCSourceFile\|modules/codec/dvbsub.c}}		* {{VLCSourceFile\|modules/codec/dvbsub.c}}

	{{Documentation}}		{{Documentation footer}}

DoesItReallyMatter: Create page marked up/adapted from source code/changelog

2019-05-28T22:11:00Z

Create page marked up/adapted from source code/changelog

New page

{{Module|name=dvbsub|type=Subtitles|first_version=0.8.0|description=[[DVB subtitles]] decoder/encoder}}
{{Clear}}

There are notes in the source code:
<syntaxhighlight lang="c">
/*****************************************************************************
* Preamble
*
* FIXME:
* DVB subtitles coded as strings of characters are not handled correctly.
* The character codes in the string should actually be indexes referring to a
* character table identified in the subtitle descriptor.
*
* The spec is quite vague in this area, but what is meant is perhaps that it
* refers to the character index in the codepage belonging to the language
* specified in the subtitle descriptor. Potentially it's designed for widechar
* (but not for UTF-*) codepages.
*****************************************************************************/
</syntaxhighlight>
and
<syntaxhighlight lang="c">
/*****************************************************************************
* Notes on DDS (Display Definition Segment)
* -----------------------------------------
* DDS (Display Definition Segment) tells the decoder how the subtitle image
* relates to the video image.
* For SD, the subtitle image is always considered to be for display at
* 720x576 (although it's assumed that for NTSC, this is 720x480, this
* is not documented well) Also, for SD, the subtitle image is drawn 'on
* the glass' (i.e. after video scaling, letterbox, etc.)
* For 'HD' (subs marked type 0x14/0x24 in PSI), a DDS must be present,
* and the subs area is drawn onto the video area (scales if necessary).
* The DDS tells the decoder what resolution the subtitle images were
* intended for, and hence how to scale the subtitle images for a
* particular video size
* i.e. if HD video is presented as letterbox, the subs will be in the
* same place on the video as if the video was presented on an HD set
* indeed, if the HD video was pillarboxed by the decoder, the subs may
* be cut off as well as the video. The intent here is that the subs can
* be placed accurately on the video - something which was missed in the
* original spec.
*
* A DDS may also specify a window - this is where the subs images are moved so that the (0,0)
* origin of decode is offset.
********************************************************************************************/
</syntaxhighlight>

== Options ==
{{Option
|name=dvbsub-position
|value=integer
|select={ 0, 1, 2, 4, 8, 5, 6, 9, 10 }
|description=Subpicture position('''[[#appendix_dvbsub-position|key]]''')
}}
{{Option
|name=dvbsub-x
|value=integer
|default=-1
|description=X coordinate of the rendered subtitle
}}
{{Option
|name=dvbsub-y
|value=integer
|default=-1
|description=Y coordinate of the rendered subtitle
}}

=== Encoder ===
{{Option
|name=sout-dvbsub-x
|value=integer
|default=-1
|description=X coordinate of the encoded subtitle
}}
{{Option
|name=sout-dvbsub-y
|value=integer
|default=-1
|description=Y coordinate of the encoded subtitle
}}
{{Clear}}

== Appendix ==

'''For the option [[#dvbsub-position|--dvbsub-position]]:'''
{{Alignment mapping}}

== Source code ==
* {{VLCSourceFile|modules/codec/dvbsub.c}}

{{Documentation}}

Documentation:Modules/dvbsub - Revision history

DoesItReallyMatter: Misc.

DoesItReallyMatter: Create page marked up/adapted from source code/changelog