DSDvd (dsj api documentation)

java.lang.Object
- java.awt.Component
- - java.awt.Canvas
  - - de.humatic.dsj.DSFiltergraph
    - - de.humatic.dsj.DSDvd

All Implemented Interfaces:

java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, javax.accessibility.Accessible
```
public class DSDvd
extends DSFiltergraph
```
DSDvd adds some DVD specific transport & navigation methods to the superclass.
Graph building for DVD playback may require that MPEG2 and AC3 decoder filters are explicitely specified (which can be done via the extended constructor or the dsj.xml file). You will likely also need to try what MPEG2 decoder actually does the job best - some non-DVD centric decoders have problems with DVDs that change size between titles. Decoders explicitely made for DVD playback may refuse to connect downstream either directly with an RGB output type or through a color space conversion filter as required by dsj's JAWT and java rendering modes. This may both be for technical reason (no support for some mediatypes) as well as for reasons of copy-protection, which may kick in on commercial DVDs soon as any kind of sample grabbing filter is inserted into the graph (the latter depending much on the OS version, with XP being a lot more gentle than Vista and Windows 7). Your best bet with DVDs generally will be using the VMR9 or EVR renderers.
Mouse operation of DVD menus can be problematic from java. With DirectShow renderers (VMR9 & EVR) most decoders should let you click menus directly, but some may not show menu highlights when hovered. Mouse operation will explicitely not be available when using the VMR7 renderer.
With the JAWT and java renderers the DVD_MENU_ENABLED flag needs to be set in the constructor, but while mouse operation as such should mostly work, menu highlighting depends on decoders and may only be available in YUV mode.
Relative navigation using the navigate(NAV_..) method should work in most cases, but whether you will get menu highlights again depends on the decoder. The SwingMovieController uses this method to let you navigate using keyboard arrow, enter and escape keys
Captions / subtitles will only be rendererd with VMR9 or EVR renderers.
Apart from all this, the class - despite some additional functionality available with dsj 0_8_62 - is still fairly incomplete and only implements a subset of DirectShow's DVD specific api.

See Also:

Serialized Form

Nested Class Summary
- Nested classes/interfaces inherited from class de.humatic.dsj.DSFiltergraph
  DSFiltergraph.DSAudioStream
- Nested classes/interfaces inherited from class java.awt.Canvas
  java.awt.Canvas.AccessibleAWTCanvas
- Nested classes/interfaces inherited from class java.awt.Component
  java.awt.Component.AccessibleAWTComponent, java.awt.Component.BaselineResizeBehavior, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`BM_DISPLAY` Menu mapping modes
`static int`	`BM_SOURCE` Menu mapping modes
`static int`	`DVD_AUD_EXT_Captions` Audio attributes
`static int`	`DVD_AUD_EXT_DirectorComments1` Audio attributes
`static int`	`DVD_AUD_EXT_DirectorComments2` Audio attributes
`static int`	`DVD_AUD_EXT_NotSpecified` Audio attributes
`static int`	`DVD_AUD_EXT_VisuallyImpaired` Audio attributes
`static int`	`DVD_AUDIO` Types for switchable streams
`static int`	`DVD_AudioDuringFFwdRew` DVDControl options
`static int`	`DVD_CacheSizeInMB` DVDControl options
`static int`	`DVD_DisableStillThrottle` DVDControl options
`static int`	`DVD_DOMAIN_FirstPlay` DVD domains
`static int`	`DVD_DOMAIN_Stop` DVD domains
`static int`	`DVD_DOMAIN_Title` DVD domains
`static int`	`DVD_DOMAIN_VideoManagerMenu` DVD domains
`static int`	`DVD_DOMAIN_VideoTitleSetMenu` DVD domains
`static int`	`DVD_EnableESOutput` DVDControl options
`static int`	`DVD_EnableExtendedCopyProtectErrors` DVDControl options
`static int`	`DVD_EnableLoggingEvents` DVDControl options
`static int`	`DVD_EnableNonblockingAPIs` DVDControl options
`static int`	`DVD_EnablePortableBookmarks` DVDControl options
`static int`	`DVD_EnableStreaming` DVDControl options
`static int`	`DVD_EnableTitleLength` DVDControl options
`static int`	`DVD_HMSF_TimeCodeEvents` DVDControl options
`static int`	`DVD_IncreaseOutputControl` DVDControl options
`static int`	`DVD_MaxReadBurstInKB` DVDControl options
`static int`	`DVD_MENU_Angle`
`static int`	`DVD_MENU_Audio`
`static int`	`DVD_MENU_Chapter`
`static int`	`DVD_MENU_LANGUAGE` Types for switchable streams
`static int`	`DVD_MENU_Root`
`static int`	`DVD_MENU_Subpicture`
`static int`	`DVD_MENU_Title`
`static int`	`DVD_NotifyParentalLevelChange` DVDControl options
`static int`	`DVD_NotifyPositionChange` DVDControl options
`static int`	`DVD_ReadBurstPeriodInMS` DVDControl options
`static int`	`DVD_ResetOnStop` DVDControl options
`static int`	`DVD_SP_EXT_Caption_Big` Subpicture attributes
`static int`	`DVD_SP_EXT_Caption_Children` Subpicture attributes
`static int`	`DVD_SP_EXT_Caption_Normal` Subpicture attributes
`static int`	`DVD_SP_EXT_CC_Big` Subpicture attributes
`static int`	`DVD_SP_EXT_CC_Children` Subpicture attributes
`static int`	`DVD_SP_EXT_CC_Normal` Subpicture attributes
`static int`	`DVD_SP_EXT_DirectorComments_Big` Subpicture attributes
`static int`	`DVD_SP_EXT_DirectorComments_Children` Subpicture attributes
`static int`	`DVD_SP_EXT_DirectorComments_Normal` Subpicture attributes
`static int`	`DVD_SP_EXT_Forced` Subpicture attributes
`static int`	`DVD_SP_EXT_NotSpecified` Subpicture attributes
`static int`	`DVD_SUBPICTURE` Types for switchable streams
`static int`	`FormatNotSupported` Dvd "warning" constants
`static int`	`IllegalNavCommand` Dvd "warning" constants
`static int`	`InvalidDVD1_0Disc` Dvd "warning" constants
`static int`	`NAV_DOWN` DVD menubutton navigation constants
`static int`	`NAV_LEFT` DVD menubutton navigation constants
`static int`	`NAV_RIGHT` DVD menubutton navigation constants
`static int`	`NAV_ROOT` DVD menubutton navigation constants
`static int`	`NAV_SELECT` DVD menubutton navigation constants
`static int`	`NAV_TITLE_MENU` DVD menubutton navigation constants
`static int`	`NAV_UP` DVD menubutton navigation constants
`static int`	`Open` Dvd "warning" constants
`static int`	`Read` Dvd "warning" constants
`static int`	`Seek` Dvd "warning" constants
`static int`	`UOP_Pause_On` User operation flags (UOPs)
`static int`	`UOP_Play_Backwards` User operation flags (UOPs)
`static int`	`UOP_Play_Chapter` User operation flags (UOPs)
`static int`	`UOP_Play_Chapter_Or_AtTime` User operation flags (UOPs)
`static int`	`UOP_Play_Forwards` User operation flags (UOPs)
`static int`	`UOP_Play_Title` User operation flags (UOPs)
`static int`	`UOP_Play_Title_Or_AtTime` User operation flags (UOPs)
`static int`	`UOP_PlayNext_Chapter` User operation flags (UOPs)
`static int`	`UOP_PlayPrev_Or_Replay_Chapter` User operation flags (UOPs)
`static int`	`UOP_Resume` User operation flags (UOPs)
`static int`	`UOP_ReturnFromSubMenu` User operation flags (UOPs)
`static int`	`UOP_Select_Angle` User operation flags (UOPs)
`static int`	`UOP_Select_Audio_Stream` User operation flags (UOPs)
`static int`	`UOP_Select_Karaoke_Audio_Presentation_Mode` User operation flags (UOPs)
`static int`	`UOP_Select_Or_Activate_Button` User operation flags (UOPs)
`static int`	`UOP_Select_SubPic_Stream` User operation flags (UOPs)
`static int`	`UOP_Select_Video_Mode_Preference` User operation flags (UOPs)
`static int`	`UOP_ShowMenu_Angle` User operation flags (UOPs)
`static int`	`UOP_ShowMenu_Audio` User operation flags (UOPs)
`static int`	`UOP_ShowMenu_Chapter` User operation flags (UOPs)
`static int`	`UOP_ShowMenu_Root` User operation flags (UOPs)
`static int`	`UOP_ShowMenu_SubPic` User operation flags (UOPs)
`static int`	`UOP_ShowMenu_Title` User operation flags (UOPs)
`static int`	`UOP_Still_Off` User operation flags (UOPs)
`static int`	`UOP_Stop` User operation flags (UOPs)

Fields inherited from class de.humatic.dsj.DSFiltergraph
ACTIVATING, ANAMORPHIC, ASYNC_BUFFER_GET, ASYNC_BUFFER_REQ, AUDIO_BUFFER_REQUEST, BDA, BDA_PRG_CHANGED, BDA_SCAN_PROGRESS, BDA_SCANNED_FREQ, BDA_SIG_REC, BUFFER_COMPLETE, BUFFERING, CALLER, CAP_STATE_CHANGED, CAPTURE, CLOSED, CLOSING, COMP_AUDIO_BUFFER_REQ, COMP_BUFFER_FILLED, COMP_VIDEO_BUFFER_REQ, D3D9, DD7, DECKLINK, DELIVER_AUDIO, DES_ERROR, DONE, DV, DV_STATE_CHANGED, DVD, DVD_FORMAT_CHANGED, DVD_MENU_ENABLED, E_CANT_PUMP_AUDIO, E_INIT_HEADLESS, EDITABLE, ENTER_FS, EPG, EVR, EXIT_FS, EXPORT_DONE, EXPORT_FINISHING, EXPORT_PROGRESS, EXPORT_STARTED, EXT_API_EVENT, FILTER_CHANGED, FORMAT_CHANGED, FRAME_CALLBACK, FRAME_LOCKED, FRAME_NOTIFY, GD, GE_DEVICE_CONNECTED, GE_DEVICE_LOST, GE_REF_REC_STOPPED, GRAPH, GRAPH_CHANGED, GRAPH_ERROR, GRAPH_EVENT, HDV, HDV_STATE_CHANGED, HEADLESS, INDEXER_DONE, INDEXER_STARTED, INIT_MUTED, INIT_PAUSED, INITIALIZED, IP_READY, J2D, JAVA_AUTODRAW, JAVA_POLL, JAVA_POLL_RGB, JAVASOUND, KEY_EVENT, KF_NOTIFY, LOCK_BUFFER, LOOP, MGD, MOUSE_ENABLED, MOUSE_EVENT, MOVIE, NATIVE_FORCE_GDI, NIO_UPDATE, NO_AMW, NO_SYNC, NULL, ONESHOT, OVERLAY, OVERLAY_BUFFER_REQUEST, PLAYLIST_PARSED, PREVIEW, RENDER_NATIVE, RESTART_REQ, RGB32, RTCP_EVENT, RTMP_EVENT, RTMP_SO_CHANGED, RTMP_STATE_CHANGED, SAMPLE_BUFFER_FILLED, SAVE_DONE, SAVE_STARTED, SBE, SBE_REC_STATE_CHANGED, SERVICE_ERROR, SERVICE_EVENT, SINK_ERROR, SINK_STATE_CHANGED, SIZE_CHANGED, SOURCE_ERROR, SOURCE_STATE_CHANGED, SOURCE_STATE_NOTIFY, SOURCE_USER_DATA, STILL_IMG_RECEIVED, STREAM_SEEK, SUBCLASS_EVENT, SUBSTREAM_INFO, SWING, SYNC_BUFFER_REQ, TABLE_RECEIVED, TIME_FORMAT_CHANGED, TRANS_IN_PLACE, TRANSPORT, TS_BUFFER_FILLED, type, URL_CHANGED, VIDEO_BUFFER_REQUEST, VMR_EMBED, VMR7, VMR9, VPJ, YUV, YUV_ORG

Fields inherited from class java.awt.Component
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors
Constructor and Description
`DSDvd(int title, int flags, DSFilterInfo mp2Decoder, DSFilterInfo ac3Decoder, java.beans.PropertyChangeListener pcl)` Opens a DVD from the default DVD drive using the specified video and audio decoders.
`DSDvd(int title, int flags, java.beans.PropertyChangeListener pcl)` Opens a DVD from the default DVD drive.
`DSDvd(java.lang.String ifoDirectory, int title, int flags, DSFilterInfo mp2Decoder, DSFilterInfo ac3Decoder, java.beans.PropertyChangeListener pcl)` Opens a DVD or DVD structure from disc, images or file.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`chapterStep(int dir)` Step fwd or bwd one DVD chapter (set %dir to 1 or -1);
`int`	`getCurrentDomain()` Returns one of the DVD_DOMAIN_ constants.
`java.lang.String`	`getInfo()`
`int`	`getNumChapters()`
`int`	`getNumChapters(int inTitle)`
`int`	`getNumTitles()`
`int`	`getSelectedStream(int type)` Returns the currently selected audio or subpicture stream.
`java.lang.String[]`	`getStreams(int type)` Returns available audio, subpicture or menu languages languages.
`boolean`	`getSubpictureState()` Returns wether or not the currently selected subpicture stream is enabled, also see selectStream(..) and setSubpictureState(..).
`int`	`getTitleDuration()` Returns the millisecond duration of the currently playing title.
`int`	`getTitleTime()` Returns playback time in the currently playing title in milliseconds.
`int`	`getUOPs()` Returns a bitmask of currently inhibited user operations (see UOP_ constants).
`int`	`gotoTitle(int title)` Jumps to the given DVD title and returns the number of chapters in that title
`void`	`navigate(int type)` Used for relative menu navigation. %type : one of the NAV_ constants
`void`	`playAtTime(int titleTime)` Start playback at the given millisecond time in the current title.
`void`	`playAtTimeInTitle(int title, int titleTime)` Start playback at the given millisecond time in the given title.
`void`	`playChapter(int c)`
`int`	`playDVD()` Attempts to resume playback from the location stopDVD() was last called and returns 0 on success.
`void`	`playPrevNextChapter(int prevNext, boolean autoStop, int numChapters)` Play the previous or next (set %prevNext to -1 or 1) chapter and optionally stop after the given number of chapters.
`void`	`restoreBookmark(java.lang.String bookmarkPath)` Restores playback location and state from the given bookmark file.
`void`	`saveBookmark(java.lang.String savePath)` Save the current playback location and state to a bookmark file.
`void`	`selectButton(int buttonID, boolean activate)` Programatically selects and eventually triggers the given menubutton.
`void`	`selectStream(int type, int index)` Selects the audio or subpicture stream at %index.
`void`	`setButtonMapping(int mode)` Sets the way in which mouse position is passed to the filtergraph when running with a DirectShow renderer or the DVD_MENU_ENABLED option set.
`void`	`setDefaultStream(int type, int index, int attributes)` Selects the default (global) audio, subpicture or menu language with the given attributes.
`void`	`setDVDControlOption(int option, int state)` Sets various optional features on the native IDVDControl2 interface.
`void`	`setSubpictureState(boolean enabled)` Turns subpicture display on or off if permitted in the current disc state.
`void`	`showMenu(int menu)` Jumps to the given menu (see DVD_MENU constants) if the dvd is in a domain where jumps are allowed;
`void`	`stillOff()`
`void`	`stopDVD()` Puts the DVD into the "Stop domain" without stopping the filtergraph.

Methods inherited from class de.humatic.dsj.DSFiltergraph
addColorSpaceConverter, addFilterToGraph, addNotify, addPropertyChangeListener, asComponent, connectDump, connectSink, createDSFiltergraph, dispose, dumpGraph, findFilterByName, findRenderer, flipImage, getActive, getAspectLocked, getAspectRatio, getAudioProperties, getAudioStream, getBitDepth, getData, getDataSize, getDisplaySize, getDuration, getEffectiveFrameRate, getFrameRate, getFullScreenWindow, getID, getImage, getLoop, getMediaDimension, getMinimumSize, getOutFlags, getPan, getPreferredSize, getRate, getRendererControls, getTime, getVolume, getYUVType, goFullScreen, graphChanged, hasMediaOfType, insertFilter, insertOverlayFilter, insertSampleAccessFilter, insertTransInPlaceFilter, isFullScreen, isSubGraph, leaveFullScreen, listFilters, lockAspectRatio, paint, pause, play, queryCapability, redraw, register, reloadFilter, removeFilter, removeNotify, removePropertyChangeListener, removeSink, setAudioRenderer, setAviExportOptions, setBounds, setClockSource, setEvent, setLoop, setPan, setPreferredSize, setRate, setTimeValue, setVolume, step, stop, tearDown, unsync, update

Methods inherited from class java.awt.Canvas
createBufferStrategy, createBufferStrategy, getAccessibleContext, getBufferStrategy

Methods inherited from class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAlignmentX, getAlignmentY, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, minimumSize, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, paramString, postEvent, preferredSize, prepareImage, prepareImage, print, printAll, processComponentEvent, processEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, setBackground, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, validate

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - NAV_SELECT
```
public static final int NAV_SELECT
```
    DVD menubutton navigation constants
    
    See Also:
    
    Constant Field Values
  - NAV_LEFT
```
public static final int NAV_LEFT
```
    DVD menubutton navigation constants
    
    See Also:
    
    Constant Field Values
  - NAV_RIGHT
```
public static final int NAV_RIGHT
```
    DVD menubutton navigation constants
    
    See Also:
    
    Constant Field Values
  - NAV_UP
```
public static final int NAV_UP
```
    DVD menubutton navigation constants
    
    See Also:
    
    Constant Field Values
  - NAV_DOWN
```
public static final int NAV_DOWN
```
    DVD menubutton navigation constants
    
    See Also:
    
    Constant Field Values
  - NAV_TITLE_MENU
```
public static final int NAV_TITLE_MENU
```
    DVD menubutton navigation constants
    
    See Also:
    
    Constant Field Values
  - NAV_ROOT
```
public static final int NAV_ROOT
```
    DVD menubutton navigation constants
    
    See Also:
    
    Constant Field Values
  - DVD_MENU_Title
```
public static final int DVD_MENU_Title
```
    See Also:
    
    Constant Field Values
  - DVD_MENU_Root
```
public static final int DVD_MENU_Root
```
    See Also:
    
    Constant Field Values
  - DVD_MENU_Subpicture
```
public static final int DVD_MENU_Subpicture
```
    See Also:
    
    Constant Field Values
  - DVD_MENU_Audio
```
public static final int DVD_MENU_Audio
```
    See Also:
    
    Constant Field Values
  - DVD_MENU_Angle
```
public static final int DVD_MENU_Angle
```
    See Also:
    
    Constant Field Values
  - DVD_MENU_Chapter
```
public static final int DVD_MENU_Chapter
```
    See Also:
    
    Constant Field Values
  - DVD_AUDIO
```
public static final int DVD_AUDIO
```
    Types for switchable streams
    
    See Also:
    
    Constant Field Values
  - DVD_SUBPICTURE
```
public static final int DVD_SUBPICTURE
```
    Types for switchable streams
    
    See Also:
    
    Constant Field Values
  - DVD_MENU_LANGUAGE
```
public static final int DVD_MENU_LANGUAGE
```
    Types for switchable streams
    
    See Also:
    
    Constant Field Values
  - DVD_AUD_EXT_NotSpecified
```
public static final int DVD_AUD_EXT_NotSpecified
```
    Audio attributes
    
    See Also:
    
    Constant Field Values
  - DVD_AUD_EXT_Captions
```
public static final int DVD_AUD_EXT_Captions
```
    Audio attributes
    
    See Also:
    
    Constant Field Values
  - DVD_AUD_EXT_VisuallyImpaired
```
public static final int DVD_AUD_EXT_VisuallyImpaired
```
    Audio attributes
    
    See Also:
    
    Constant Field Values
  - DVD_AUD_EXT_DirectorComments1
```
public static final int DVD_AUD_EXT_DirectorComments1
```
    Audio attributes
    
    See Also:
    
    Constant Field Values
  - DVD_AUD_EXT_DirectorComments2
```
public static final int DVD_AUD_EXT_DirectorComments2
```
    Audio attributes
    
    See Also:
    
    Constant Field Values
  - DVD_SP_EXT_NotSpecified
```
public static final int DVD_SP_EXT_NotSpecified
```
    Subpicture attributes
    
    See Also:
    
    Constant Field Values
  - DVD_SP_EXT_Caption_Normal
```
public static final int DVD_SP_EXT_Caption_Normal
```
    Subpicture attributes
    
    See Also:
    
    Constant Field Values
  - DVD_SP_EXT_Caption_Big
```
public static final int DVD_SP_EXT_Caption_Big
```
    Subpicture attributes
    
    See Also:
    
    Constant Field Values
  - DVD_SP_EXT_Caption_Children
```
public static final int DVD_SP_EXT_Caption_Children
```
    Subpicture attributes
    
    See Also:
    
    Constant Field Values
  - DVD_SP_EXT_CC_Normal
```
public static final int DVD_SP_EXT_CC_Normal
```
    Subpicture attributes
    
    See Also:
    
    Constant Field Values
  - DVD_SP_EXT_CC_Big
```
public static final int DVD_SP_EXT_CC_Big
```
    Subpicture attributes
    
    See Also:
    
    Constant Field Values
  - DVD_SP_EXT_CC_Children
```
public static final int DVD_SP_EXT_CC_Children
```
    Subpicture attributes
    
    See Also:
    
    Constant Field Values
  - DVD_SP_EXT_Forced
```
public static final int DVD_SP_EXT_Forced
```
    Subpicture attributes
    
    See Also:
    
    Constant Field Values
  - DVD_SP_EXT_DirectorComments_Normal
```
public static final int DVD_SP_EXT_DirectorComments_Normal
```
    Subpicture attributes
    
    See Also:
    
    Constant Field Values
  - DVD_SP_EXT_DirectorComments_Big
```
public static final int DVD_SP_EXT_DirectorComments_Big
```
    Subpicture attributes
    
    See Also:
    
    Constant Field Values
  - DVD_SP_EXT_DirectorComments_Children
```
public static final int DVD_SP_EXT_DirectorComments_Children
```
    Subpicture attributes
    
    See Also:
    
    Constant Field Values
  - DVD_ResetOnStop
```
public static final int DVD_ResetOnStop
```
    DVDControl options
    
    See Also:
    
    Constant Field Values
  - DVD_NotifyParentalLevelChange
```
public static final int DVD_NotifyParentalLevelChange
```
    DVDControl options
    
    See Also:
    
    Constant Field Values
  - DVD_HMSF_TimeCodeEvents
```
public static final int DVD_HMSF_TimeCodeEvents
```
    DVDControl options
    
    See Also:
    
    Constant Field Values
  - DVD_AudioDuringFFwdRew
```
public static final int DVD_AudioDuringFFwdRew
```
    DVDControl options
    
    See Also:
    
    Constant Field Values
  - DVD_EnableNonblockingAPIs
```
public static final int DVD_EnableNonblockingAPIs
```
    DVDControl options
    
    See Also:
    
    Constant Field Values
  - DVD_CacheSizeInMB
```
public static final int DVD_CacheSizeInMB
```
    DVDControl options
    
    See Also:
    
    Constant Field Values
  - DVD_EnablePortableBookmarks
```
public static final int DVD_EnablePortableBookmarks
```
    DVDControl options
    
    See Also:
    
    Constant Field Values
  - DVD_EnableExtendedCopyProtectErrors
```
public static final int DVD_EnableExtendedCopyProtectErrors
```
    DVDControl options
    
    See Also:
    
    Constant Field Values
  - DVD_NotifyPositionChange
```
public static final int DVD_NotifyPositionChange
```
    DVDControl options
    
    See Also:
    
    Constant Field Values
  - DVD_IncreaseOutputControl
```
public static final int DVD_IncreaseOutputControl
```
    DVDControl options
    
    See Also:
    
    Constant Field Values
  - DVD_EnableStreaming
```
public static final int DVD_EnableStreaming
```
    DVDControl options
    
    See Also:
    
    Constant Field Values
  - DVD_EnableESOutput
```
public static final int DVD_EnableESOutput
```
    DVDControl options
    
    See Also:
    
    Constant Field Values
  - DVD_EnableTitleLength
```
public static final int DVD_EnableTitleLength
```
    DVDControl options
    
    See Also:
    
    Constant Field Values
  - DVD_DisableStillThrottle
```
public static final int DVD_DisableStillThrottle
```
    DVDControl options
    
    See Also:
    
    Constant Field Values
  - DVD_EnableLoggingEvents
```
public static final int DVD_EnableLoggingEvents
```
    DVDControl options
    
    See Also:
    
    Constant Field Values
  - DVD_MaxReadBurstInKB
```
public static final int DVD_MaxReadBurstInKB
```
    DVDControl options
    
    See Also:
    
    Constant Field Values
  - DVD_ReadBurstPeriodInMS
```
public static final int DVD_ReadBurstPeriodInMS
```
    DVDControl options
    
    See Also:
    
    Constant Field Values
  - UOP_Play_Title_Or_AtTime
```
public static final int UOP_Play_Title_Or_AtTime
```
    User operation flags (UOPs)
    
    See Also:
    
    Constant Field Values
  - UOP_Play_Chapter
```
public static final int UOP_Play_Chapter
```
    User operation flags (UOPs)
    
    See Also:
    
    Constant Field Values
  - UOP_Play_Title
```
public static final int UOP_Play_Title
```
    User operation flags (UOPs)
    
    See Also:
    
    Constant Field Values
  - UOP_Stop
```
public static final int UOP_Stop
```
    User operation flags (UOPs)
    
    See Also:
    
    Constant Field Values
  - UOP_ReturnFromSubMenu
```
public static final int UOP_ReturnFromSubMenu
```
    User operation flags (UOPs)
    
    See Also:
    
    Constant Field Values
  - UOP_Play_Chapter_Or_AtTime
```
public static final int UOP_Play_Chapter_Or_AtTime
```
    User operation flags (UOPs)
    
    See Also:
    
    Constant Field Values
  - UOP_PlayPrev_Or_Replay_Chapter
```
public static final int UOP_PlayPrev_Or_Replay_Chapter
```
    User operation flags (UOPs)
    
    See Also:
    
    Constant Field Values
  - UOP_PlayNext_Chapter
```
public static final int UOP_PlayNext_Chapter
```
    User operation flags (UOPs)
    
    See Also:
    
    Constant Field Values
  - UOP_Play_Forwards
```
public static final int UOP_Play_Forwards
```
    User operation flags (UOPs)
    
    See Also:
    
    Constant Field Values
  - UOP_Play_Backwards
```
public static final int UOP_Play_Backwards
```
    User operation flags (UOPs)
    
    See Also:
    
    Constant Field Values
  - UOP_ShowMenu_Title
```
public static final int UOP_ShowMenu_Title
```
    User operation flags (UOPs)
    
    See Also:
    
    Constant Field Values
  - UOP_ShowMenu_Root
```
public static final int UOP_ShowMenu_Root
```
    User operation flags (UOPs)
    
    See Also:
    
    Constant Field Values
  - UOP_ShowMenu_SubPic
```
public static final int UOP_ShowMenu_SubPic
```
    User operation flags (UOPs)
    
    See Also:
    
    Constant Field Values
  - UOP_ShowMenu_Audio
```
public static final int UOP_ShowMenu_Audio
```
    User operation flags (UOPs)
    
    See Also:
    
    Constant Field Values
  - UOP_ShowMenu_Angle
```
public static final int UOP_ShowMenu_Angle
```
    User operation flags (UOPs)
    
    See Also:
    
    Constant Field Values
  - UOP_ShowMenu_Chapter
```
public static final int UOP_ShowMenu_Chapter
```
    User operation flags (UOPs)
    
    See Also:
    
    Constant Field Values
  - UOP_Resume
```
public static final int UOP_Resume
```
    User operation flags (UOPs)
    
    See Also:
    
    Constant Field Values
  - UOP_Select_Or_Activate_Button
```
public static final int UOP_Select_Or_Activate_Button
```
    User operation flags (UOPs)
    
    See Also:
    
    Constant Field Values
  - UOP_Still_Off
```
public static final int UOP_Still_Off
```
    User operation flags (UOPs)
    
    See Also:
    
    Constant Field Values
  - UOP_Pause_On
```
public static final int UOP_Pause_On
```
    User operation flags (UOPs)
    
    See Also:
    
    Constant Field Values
  - UOP_Select_Audio_Stream
```
public static final int UOP_Select_Audio_Stream
```
    User operation flags (UOPs)
    
    See Also:
    
    Constant Field Values
  - UOP_Select_SubPic_Stream
```
public static final int UOP_Select_SubPic_Stream
```
    User operation flags (UOPs)
    
    See Also:
    
    Constant Field Values
  - UOP_Select_Angle
```
public static final int UOP_Select_Angle
```
    User operation flags (UOPs)
    
    See Also:
    
    Constant Field Values
  - UOP_Select_Karaoke_Audio_Presentation_Mode
```
public static final int UOP_Select_Karaoke_Audio_Presentation_Mode
```
    User operation flags (UOPs)
    
    See Also:
    
    Constant Field Values
  - UOP_Select_Video_Mode_Preference
```
public static final int UOP_Select_Video_Mode_Preference
```
    User operation flags (UOPs)
    
    See Also:
    
    Constant Field Values
  - DVD_DOMAIN_FirstPlay
```
public static final int DVD_DOMAIN_FirstPlay
```
    DVD domains
    
    See Also:
    
    Constant Field Values
  - DVD_DOMAIN_VideoManagerMenu
```
public static final int DVD_DOMAIN_VideoManagerMenu
```
    DVD domains
    
    See Also:
    
    Constant Field Values
  - DVD_DOMAIN_VideoTitleSetMenu
```
public static final int DVD_DOMAIN_VideoTitleSetMenu
```
    DVD domains
    
    See Also:
    
    Constant Field Values
  - DVD_DOMAIN_Title
```
public static final int DVD_DOMAIN_Title
```
    DVD domains
    
    See Also:
    
    Constant Field Values
  - DVD_DOMAIN_Stop
```
public static final int DVD_DOMAIN_Stop
```
    DVD domains
    
    See Also:
    
    Constant Field Values
  - BM_DISPLAY
```
public static final int BM_DISPLAY
```
    Menu mapping modes
    
    See Also:
    
    Constant Field Values
  - BM_SOURCE
```
public static final int BM_SOURCE
```
    Menu mapping modes
    
    See Also:
    
    Constant Field Values
  - InvalidDVD1_0Disc
```
public static final int InvalidDVD1_0Disc
```
    Dvd "warning" constants
    
    See Also:
    
    Constant Field Values
  - FormatNotSupported
```
public static final int FormatNotSupported
```
    Dvd "warning" constants
    
    See Also:
    
    Constant Field Values
  - IllegalNavCommand
```
public static final int IllegalNavCommand
```
    Dvd "warning" constants
    
    See Also:
    
    Constant Field Values
  - Open
```
public static final int Open
```
    Dvd "warning" constants
    
    See Also:
    
    Constant Field Values
  - Seek
```
public static final int Seek
```
    Dvd "warning" constants
    
    See Also:
    
    Constant Field Values
  - Read
```
public static final int Read
```
    Dvd "warning" constants
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - DSDvd
```
public DSDvd(int title,
             int flags,
             java.beans.PropertyChangeListener pcl)
      throws DSJException
```
    Opens a DVD from the default DVD drive.
    
    Throws:
    
    DSJException
  - DSDvd
```
public DSDvd(int title,
             int flags,
             DSFilterInfo mp2Decoder,
             DSFilterInfo ac3Decoder,
             java.beans.PropertyChangeListener pcl)
      throws DSJException
```
    Opens a DVD from the default DVD drive using the specified video and audio decoders.
    
    Throws:
    
    DSJException
  - DSDvd
```
public DSDvd(java.lang.String ifoDirectory,
             int title,
             int flags,
             DSFilterInfo mp2Decoder,
             DSFilterInfo ac3Decoder,
             java.beans.PropertyChangeListener pcl)
      throws java.lang.Exception
```
    Opens a DVD or DVD structure from disc, images or file.
    
    Throws:
    
    java.lang.Exception
- Method Detail
  - getInfo
```
public java.lang.String getInfo()
```
    Overrides:
    
    getInfo in class DSFiltergraph
  - showMenu
```
public void showMenu(int menu)
              throws DSJException
```
    Jumps to the given menu (see DVD_MENU constants) if the dvd is in a domain where jumps are allowed;
    
    Throws:
    
    DSJException
  - chapterStep
```
public void chapterStep(int dir)
                 throws DSJException
```
    Step fwd or bwd one DVD chapter (set %dir to 1 or -1);
    
    Throws:
    
    DSJException
  - gotoTitle
```
public int gotoTitle(int title)
              throws DSJException
```
    Jumps to the given DVD title and returns the number of chapters in that title
    
    Throws:
    
    DSJException
  - selectButton
```
public void selectButton(int buttonID,
                         boolean activate)
                  throws DSJException
```
    Programatically selects and eventually triggers the given menubutton. Button indices are 1 based and there are at most 36 buttons at any given time.
    
    Throws:
    
    DSJException
  - getNumChapters
```
public int getNumChapters()
```
  - getNumChapters
```
public int getNumChapters(int inTitle)
```
  - getNumTitles
```
public int getNumTitles()
```
  - playChapter
```
public void playChapter(int c)
                 throws DSJException
```
    Throws:
    
    DSJException
  - navigate
```
public void navigate(int type)
              throws DSJException
```
    Used for relative menu navigation.
    %type : one of the NAV_ constants
    
    Throws:
    
    DSJException
  - setButtonMapping
```
public void setButtonMapping(int mode)
```
    Sets the way in which mouse position is passed to the filtergraph when running with a DirectShow renderer or the DVD_MENU_ENABLED option set. Dedicated DVD decoders usually take mouse coordinates in display space (BM_DISPLAY, default setting), while more general purpose MPEG2 decoders may want them in original source space (BM_SOURCE).
  - stopDVD
```
public void stopDVD()
             throws DSJException
```
    Puts the DVD into the "Stop domain" without stopping the filtergraph. This may be required for some operations that change playback characteristics (setDefaultStream() uses this internally).
    
    Throws:
    
    DSJException
  - playDVD
```
public int playDVD()
            throws DSJException
```
    Attempts to resume playback from the location stopDVD() was last called and returns 0 on success. This may fail for various reasons depending on the current playback location and the DVD's authoring. In such cases the method will try to resume from the start of the current title, returning 1 if successful, or - in case this also fails - show the root menu and return 2. Negative return values signalling other problems not handled internally will throw an exception and be transferred in the DSJException's errorcode field.
    
    Throws:
    
    DSJException
  - stillOff
```
public void stillOff()
```
  - getStreams
```
public java.lang.String[] getStreams(int type)
                              throws DSJException
```
    Returns available audio, subpicture or menu languages languages. The return will vary depending on where in the DVD streams are queried for.
    
    Throws:
    
    DSJException
  - getSelectedStream
```
public int getSelectedStream(int type)
                      throws DSJException
```
    Returns the currently selected audio or subpicture stream. For subpictures, the stream may be selected but disabled in the current domain or by user choice, use getSubpictureState() to determine if it is active.
    
    Throws:
    
    DSJException
  - selectStream
```
public void selectStream(int type,
                         int index)
                  throws DSJException
```
    Selects the audio or subpicture stream at %index. This operation may not be permitted at all times and will throw exceptions with errorcode 0x80040276 - VFW_E_DVD_OPERATION_INHIBITED - in case (see getUOPs to determine what operations will be available prior to invoking them).
    
    Throws:
    
    DSJException
  - setSubpictureState
```
public void setSubpictureState(boolean enabled)
                        throws DSJException
```
    Turns subpicture display on or off if permitted in the current disc state. Subpicture streams are used in menus for button text and eventually for subtitles and credits over video playback. What this method actually does depends a bit on the authoring of the DVD. For example translations of titles may not be switchable and subtitles - then rather captions - may also come as Line21 data in the video stream, in which case this method will not affect them).
    
    Throws:
    
    DSJException
  - getSubpictureState
```
public boolean getSubpictureState()
                           throws DSJException
```
    Returns wether or not the currently selected subpicture stream is enabled, also see selectStream(..) and setSubpictureState(..).
    
    Throws:
    
    DSJException
  - setDefaultStream
```
public void setDefaultStream(int type,
                             int index,
                             int attributes)
                      throws DSJException
```
    Selects the default (global) audio, subpicture or menu language with the given attributes. As these operations are only permitted in the "Stop domain", the method will stop the DVD and wait for the stop operation to complete, before issueing the stream change command. Playback will be restarted afterwards.
    %index - index into the available streams of %type.
    %attributes - one of the DVD_AUDIO_EXT_ or DVD_SP_EXT_ constants, 0 for menu languages.
    
    Throws:
    
    DSJException
  - getCurrentDomain
```
public int getCurrentDomain()
```
    Returns one of the DVD_DOMAIN_ constants.
  - getTitleDuration
```
public int getTitleDuration()
```
    Returns the millisecond duration of the currently playing title. This will fail on menus.
  - getTitleTime
```
public int getTitleTime()
```
    Returns playback time in the currently playing title in milliseconds. Alternatively to calling this method, you can convert the first parameter of EC_DVD_CURRENT_TIME or EC_DVD_CURRENT_HMSF_TIME (when timecode format has been changed using setDVDControlOption(...)) events.
  - getUOPs
```
public int getUOPs()
```
    Returns a bitmask of currently inhibited user operations (see UOP_ constants). If a bit is set, the corresponding operation is not allowed at the current state.
  - saveBookmark
```
public void saveBookmark(java.lang.String savePath)
                  throws java.io.IOException,
                         DSJException
```
    Save the current playback location and state to a bookmark file. %savePath can be null to save for internal reuse only. On Vista and beyond the bookmark will be portable (i.e. useable on another machine) long as this has not been disabled with the setDVDControlOption(..) method.
    
    Throws:
    
    java.io.IOException
    
    DSJException
  - restoreBookmark
```
public void restoreBookmark(java.lang.String bookmarkPath)
                     throws java.io.IOException,
                            DSJException
```
    Restores playback location and state from the given bookmark file. %bookmarkPath can be null to restore to the last save state.
    
    Throws:
    
    java.io.IOException
    
    DSJException
  - playAtTime
```
public void playAtTime(int titleTime)
                throws DSJException
```
    Start playback at the given millisecond time in the current title.
    
    Throws:
    
    DSJException
  - playAtTimeInTitle
```
public void playAtTimeInTitle(int title,
                              int titleTime)
                       throws DSJException
```
    Start playback at the given millisecond time in the given title.
    
    Throws:
    
    DSJException
  - playPrevNextChapter
```
public void playPrevNextChapter(int prevNext,
                                boolean autoStop,
                                int numChapters)
                         throws DSJException
```
    Play the previous or next (set %prevNext to -1 or 1) chapter and optionally stop after the given number of chapters.
    
    Throws:
    
    DSJException
  - setDVDControlOption
```
public void setDVDControlOption(int option,
                                int state)
                         throws DSJException
```
    Sets various optional features on the native IDVDControl2 interface. See msdn DVD_OPTION_FLAG docs for details.
    %option - one of the DVDControl option constants.
    %state - interpreted as boolean (1 - true, 0 - false) for most options.
    By default dsj disables ResetOnStop and - on Vista and beyond - enables portable bookmarks.
    
    Throws:
    
    DSJException

Class DSDvd

Nested Class Summary

Nested classes/interfaces inherited from class de.humatic.dsj.DSFiltergraph

Nested classes/interfaces inherited from class java.awt.Canvas

Nested classes/interfaces inherited from class java.awt.Component

Field Summary

Fields inherited from class de.humatic.dsj.DSFiltergraph

Fields inherited from class java.awt.Component

Fields inherited from interface java.awt.image.ImageObserver

Constructor Summary

Method Summary

Methods inherited from class de.humatic.dsj.DSFiltergraph

Methods inherited from class java.awt.Canvas

Methods inherited from class java.awt.Component

Methods inherited from class java.lang.Object

Field Detail

NAV_SELECT

NAV_LEFT

NAV_RIGHT

NAV_UP

NAV_DOWN

NAV_TITLE_MENU

NAV_ROOT

DVD_MENU_Title

DVD_MENU_Root

DVD_MENU_Subpicture

DVD_MENU_Audio

DVD_MENU_Angle

DVD_MENU_Chapter

DVD_AUDIO

DVD_SUBPICTURE

DVD_MENU_LANGUAGE

DVD_AUD_EXT_NotSpecified

DVD_AUD_EXT_Captions

DVD_AUD_EXT_VisuallyImpaired

DVD_AUD_EXT_DirectorComments1

DVD_AUD_EXT_DirectorComments2

DVD_SP_EXT_NotSpecified

DVD_SP_EXT_Caption_Normal

DVD_SP_EXT_Caption_Big

DVD_SP_EXT_Caption_Children

DVD_SP_EXT_CC_Normal

DVD_SP_EXT_CC_Big

DVD_SP_EXT_CC_Children

DVD_SP_EXT_Forced

DVD_SP_EXT_DirectorComments_Normal

DVD_SP_EXT_DirectorComments_Big

DVD_SP_EXT_DirectorComments_Children

DVD_ResetOnStop

DVD_NotifyParentalLevelChange

DVD_HMSF_TimeCodeEvents

DVD_AudioDuringFFwdRew

DVD_EnableNonblockingAPIs

DVD_CacheSizeInMB

DVD_EnablePortableBookmarks

DVD_EnableExtendedCopyProtectErrors

DVD_NotifyPositionChange

DVD_IncreaseOutputControl

DVD_EnableStreaming

DVD_EnableESOutput

DVD_EnableTitleLength

DVD_DisableStillThrottle

DVD_EnableLoggingEvents

DVD_MaxReadBurstInKB

DVD_ReadBurstPeriodInMS

UOP_Play_Title_Or_AtTime

UOP_Play_Chapter

UOP_Play_Title

UOP_Stop

UOP_ReturnFromSubMenu

UOP_Play_Chapter_Or_AtTime

UOP_PlayPrev_Or_Replay_Chapter

UOP_PlayNext_Chapter

UOP_Play_Forwards

UOP_Play_Backwards

UOP_ShowMenu_Title

UOP_ShowMenu_Root

UOP_ShowMenu_SubPic

UOP_ShowMenu_Audio

UOP_ShowMenu_Angle