Difference between revisions of "Documentation Talk:Subtitles"

From VideoLAN Wiki
Jump to navigation Jump to search
m (copy-edit for clarity)
(paraphrase (hopefully keeping original thought intact))
Line 1: Line 1:
I believe there to be an incorrect statement with regard to the default state of subtitles.
+
== Error in the documentation regarding subtitle track value ==
 +
The documentation claims that in the input/codecs tab in preferences, setting the "subtitle track" value to "0" will disable subtitles by default. In actuality (as of VLC 2.1.5) a value of "-1" will disable subtitles.
  
The statement refers to the input/codecs tab in the preferences, specifically the "subtitle track" value.  The documentation claims that a "0" value disables subtitles by default, but this does not appear to be true &mdash; at least not with current release of VLC (2.1.5).<br />
+
Furthermore, it appears that the subtitle track number is not a boolean/toggle setting, but a ''relative index'' for the "Subtitle>Sub Track" selection menu; with "-1" corresponding to "Disable", "0" for the first subtitle-track, "1" for the second track, and so on...
I have discovered that the value DOES affect the subtitle track &mdash; but it serves as a "relative index" value for the "Subtitle>Sub Track" selection menu.  A "-1" corresponds to "Disable", a "0" to the first subtitle-track, a "1" to the second track, and so on...<br />
 
Currently, this doc claims that a value of "0" disables subtitles.  This should say "-1" to turn subtitles off by default. The statement (instructing how to disable subtitles by default):
 
  
:<tt>On the "Subtitle Track ID" selection window, change the value to "0".</tt>
+
I suppose it might be more intuitive if the values did start at "0", as then a "1" would correspond to subtitle track 1... but it appears that this setting instead adheres to the convention of "-1" to disable an option or feature.
 
 
I have verified that when set to "-1", the Subtitles>Sub Track is set to "Disable".  When I change the value to "0", the first subtitle track is selected; a value of "1" caused the ''second'' subtitle track to be selected, and so on.<br />
 
It might be more intuitive if the values did start at "0" (for disabled), as then a "1" would correspond to subtitle track 1... but for now, it is offset by -1 &mdash; which adheres to the convention that "-1" is used to disable an option or feature.<br />
 
Apologies for the extremely verbose entry here, but as it is my first I want to ensure that I provide full context and leave no room for misinterpretation.
 
 
 
The ''problem'' though, in short, is very simple.  The wiki should state that "-1" is the correct value to disable subtitles.  It ''could'' be enhanced with wording that explains that the value corresponds to Sub Track, as mentioned above, with 0:sub-track-1, 1:sub-track-2, etc..  At a minimum, for the short term, I propose that the statement be changed to:
 
 
 
:<tt>On the "Subtitle Track ID" selection window, change the value to "-1".</tt>
 
  
 
At present, the doc is simply incorrect ;-)
 
At present, the doc is simply incorrect ;-)
  
--[[User:Aprilia1k|Aprilia1k]] ([[User talk:Aprilia1k|talk]]) 18:50, 1 February 2015 (CET)
+
--[[User:Aprilia1k|Aprilia1k]] ([[User talk:Aprilia1k|talk]]) 18:50, 1 February 2015 (CET), <small>edited for conciseness by {{User:DoesItReallyMatter/real_sig}} 09:45, 24 February 2015 (CET)</small>

Revision as of 08:45, 24 February 2015

Error in the documentation regarding subtitle track value

The documentation claims that in the input/codecs tab in preferences, setting the "subtitle track" value to "0" will disable subtitles by default. In actuality (as of VLC 2.1.5) a value of "-1" will disable subtitles.

Furthermore, it appears that the subtitle track number is not a boolean/toggle setting, but a relative index for the "Subtitle>Sub Track" selection menu; with "-1" corresponding to "Disable", "0" for the first subtitle-track, "1" for the second track, and so on...

I suppose it might be more intuitive if the values did start at "0", as then a "1" would correspond to subtitle track 1... but it appears that this setting instead adheres to the convention of "-1" to disable an option or feature.

At present, the doc is simply incorrect ;-)

--Aprilia1k (talk) 18:50, 1 February 2015 (CET), edited for conciseness by DoesItReallyMatter (talk) 09:45, 24 February 2015 (CET)