### Example: Convert SUP to SUB with English Language and NTSC Resolution

Source: https://github.com/amichaelt/bdsup2subplusplus/blob/master/src/help.htm

Demonstrates converting a SUP file to SUB format, specifying English language and NTSC resolution.

```Command Line
java -jar BDSup2Sub.jar sup2.sup sup2.sub /lang:no /atr:40 /res:1080 /forced /fps:24p,25p
```

--------------------------------

### Example: Convert SUP to SUB with Specific Settings

Source: https://github.com/amichaelt/bdsup2subplusplus/blob/master/src/help.htm

Shows conversion from SUP to SUB with Norwegian language, alpha threshold of 40, 1080 resolution, forced flag, and specific FPS settings.

```Command Line
java -jar BDSup2Sub.jar sup2.sup sup2_exp.sup /lang:no /atr:40 /res:720p /forced-
```

--------------------------------

### BDSup2Sub INI File Settings

Source: https://github.com/amichaelt/bdsup2subplusplus/blob/master/src/help.htm

Example of settings stored in the BDSup2Sub INI file. These settings are used as defaults and can be modified via command line parameters.

```ini
#BDSup2Sub 3.9.5 settings - don't modify manually  
#Sat Jun 27 13:28:05 CEST 2009  
fixZeroAlpha=true  
filter=Mitchell  
loadPath=D\\:\\src\\Java\\BDSup2Sub\\reference\\colored-forced.idx  
mergePTSdiff=18000  
frameHeight=600  
framePosY=197  
framePosX=241  
alphaCrop=14  
frameWidth=799  
verbatim=true  
savePath=D\\:\\src\\Java\\BDSup2Sub\\reference\\colored-forced.idx  
colorPath=  
paletteMode=keep existing
```

--------------------------------

### Windows Registry for SUP File Association

Source: https://github.com/amichaelt/bdsup2subplusplus/blob/master/src/help.htm

Register BDSup2Sub as the default application for SUP files in Windows by creating and importing a .reg file. Ensure paths to Java runtime and BDSup2Sub installation are correctly specified with double backslashes.

```reg
Windows Registry Editor Version 5.00

[HKEY_CLASSES_ROOT\.sup]
@="SUP BD/HD-DVD caption stream"

[HKEY_CLASSES_ROOT\.sup\shell]

[HKEY_CLASSES_ROOT\.sup\shell\open]

[HKEY_CLASSES_ROOT\.sup\shell\open\command]
@="E:\\dev\\java\\jre_6_0\\bin\\javaw.exe -jar d:\\src\\java\\BDSup2Sub\\BDSup2Sub.jar \"%1\""
```

--------------------------------

### Sony BDN XML Format Example

Source: https://github.com/amichaelt/bdsup2subplusplus/blob/master/src/help.htm

This XML structure defines subtitle events, including timing, graphic file references, and positioning. It is used for the Sony BDN XML format.

```xml
<?xml version="1.0" encoding="UTF-8"?>
<BDN Version="0.93" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="BD-03-006-0093b BDN File Format.xsd">
  <Description>
    <Name Title="BDN Example" Content=""/>
    <Language Code="eng"/>
    <Format VideoFormat="720p" FrameRate="23.976" DropFrame="False"/>
    <Events Type="Graphic" FirstEventInTC="00:00:00:00" LastEventOutTC="02:26:38:18" NumberofEvents="22"/>
  </Description>
  <Events>
    <Event InTC="00:00:00:00" OutTC="00:00:05:00" Forced="False">
      <Graphic Width="1" Height="1" X="0" Y="0">subtitles_0001.png</Graphic>
    </Event>
    ...
    <Event InTC="02:26:35:12" OutTC="02:26:38:18" Forced="False">
      <Graphic Width="601" Height="88" X="343" Y="511">subtitles_0022.png</Graphic>
    </Event>
  </Events>
</BDN>
```

--------------------------------

### Command Line with Wildcards

Source: https://github.com/amichaelt/bdsup2subplusplus/blob/master/src/help.htm

Use wildcards like '*' and '?' for source and target file names when running BDSup2Sub from the command line. Enclose the entire parameter string in double quotes if wildcards are used.

```bash
java -jar BDSup2Sub.jar "reference\m?trix*.sup out\*.idx /lang:en /res:ntsc"
```

```bash
java -jar BDSup2Sub.jar 'in path\m?trix*.sup' 'out path\*.idx' /lang:no /atr:40 /res:1080 /forced
```

--------------------------------

### Load Palette File

Source: https://github.com/amichaelt/bdsup2subplusplus/blob/master/src/help.htm

Loads a palette file (INI format) created from BDSup2Subs color edit dialog.

```Command Line
java -jar BDSup2Sub.jar sup2.sup sup2.sub /lang:en /res:ntsc
```

--------------------------------

### Set Palette Mode

Source: https://github.com/amichaelt/bdsup2subplusplus/blob/master/src/help.htm

Sets the palette mode to 'keep', 'create', or 'dither'. Default is 'create'. Ignored for SUB/IDX exports if import format is not SUB/IDX. 'dither' is equivalent to 'create' for SUB/IDX to SUB/IDX.

```Command Line
/atr:<n>
```

--------------------------------

### Export Target Palette

Source: https://github.com/amichaelt/bdsup2subplusplus/blob/master/src/help.htm

Exports the target palette in PGCEdit text format. Default is off (no export).

```Command Line
/fixinv[+/-]
```

--------------------------------

### Switch on Verbatim Console Output

Source: https://github.com/amichaelt/bdsup2subplusplus/blob/master/src/help.htm

Enables verbatim console output mode. Default is off.

```Command Line
/palmode:<s>
```

--------------------------------

### Set Language

Source: https://github.com/amichaelt/bdsup2subplusplus/blob/master/src/help.htm

Sets the subtitle language using a string code (e.g., 'en' for English). Default is 'de'. Supports XML and BD-SUP exports with limitations.

```Command Line
/pal:<s>
```

--------------------------------

### Fix Zero Alpha Frame Palette

Source: https://github.com/amichaelt/bdsup2subplusplus/blob/master/src/help.htm

Automatically fixes the palette for frames with zero alpha. Default is off. Ignored if import format is not SUB/IDX or SUP/IFO.

```Command Line
/verbatim[+/-]
```

--------------------------------

### Set Luminance Low/Mid Threshold

Source: https://github.com/amichaelt/bdsup2subplusplus/blob/master/src/help.htm

Sets the luminance threshold for low to mid values, ranging from 0 to 255. Default is automatic.

```Command Line
/ltr2:<n>
```

--------------------------------

### Set Luminance Mid/High Threshold

Source: https://github.com/amichaelt/bdsup2subplusplus/blob/master/src/help.htm

Sets the luminance threshold for mid to high values, ranging from 0 to 255. Default is automatic.

```Command Line
/lang:<s>
```

--------------------------------

### Scale Captions with Free Factors

Source: https://github.com/amichaelt/bdsup2subplusplus/blob/master/src/help.htm

Scales subtitle captions using specified factors for X and Y dimensions. Defaults are 1.0, 1.0, with a min of 0.5 and max of 2.0.

```Command Line
/exppal[+/-]
```

--------------------------------

### Crop Upper and Lower Lines

Source: https://github.com/amichaelt/bdsup2subplusplus/blob/master/src/help.htm

Crops a specified number of lines from the top and bottom of the subtitle image. Default is 0.

```Command Line
/acrop:<n>
```

--------------------------------

### Set Alpha Threshold

Source: https://github.com/amichaelt/bdsup2subplusplus/blob/master/src/help.htm

Sets the alpha threshold for processing, ranging from 0 to 255. Default is 80.

```Command Line
/ltr1:<n>
```

--------------------------------

### Set Alpha Cropping Threshold

Source: https://github.com/amichaelt/bdsup2subplusplus/blob/master/src/help.htm

Sets the threshold for automatic cropping of caption images based on alpha values. Default is 10.

```Command Line
/scale:<x>,<y>
```

--------------------------------

### Increase Java RAM Size

Source: https://github.com/amichaelt/bdsup2subplusplus/blob/master/src/help.htm

Increase the maximum heap size for Java applications to prevent memory issues when loading large SUP files or importing large images. This parameter must precede the '-jar' argument.

```bash
java -Xmx256m -jar BDSup2Sub.jar
```

--------------------------------

### Disable Direct3D Support

Source: https://github.com/amichaelt/bdsup2subplusplus/blob/master/src/help.htm

Disable Direct3D for Java to resolve visual artifacts or system crashes caused by JRE or video card driver bugs. This can be done globally via an environment variable.

```bash
_JAVA_OPTIONS=-Dsun.java2d.d3d=false
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.