de.humatic.dsj

Class DSDvd

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, SWING, SYNC_BUFFER_REQ, TABLE_RECEIVED, TIME_FORMAT_CHANGED, TRANS_IN_PLACE, TRANSPORT, TS_BUFFER_FILLED, type, VIDEO_BUFFER_REQUEST, VMR_EMBED, VMR7, VMR9, VPJ, YUV, YUV_ORG

Fields inherited from class java.awt.Component

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

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	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, 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()

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