Класс MediaView

public class MediaView
extends Node

Элемент Node, который предоставляет просмотр воспроизведения Media с помощью MediaPlayer.

Следующий фрагмент кода демонстрирует пример метода Application.start(), который отображает видео:

public void start(Stage stage) {
     // Create and set the Scene.
     Scene scene = new Scene(new Group(), 540, 209);
     stage.setScene(scene);

     // Name and display the Stage.
     stage.setTitle("Hello Media");
     stage.show();

     // Create the media source.
     String source = getParameters().getRaw().get(0);
     Media media = new Media(source);

     // Create the player and set to play automatically.
     MediaPlayer mediaPlayer = new MediaPlayer(media);
     mediaPlayer.setAutoPlay(true);

     // Create the view and add it to the Scene.
     MediaView mediaView = new MediaView(mediaPlayer);
     ((Group) scene.getRoot()).getChildren().add(mediaView);
 }

Приведенный выше код отобразит видео как:

• Краткое описание свойств

  Все методыМетоды экземпляраКонкретные методы

  Тип	Свойство и описание
  DoubleProperty	fitHeight Определяет высоту ограничивающей области, в которой исходное медиа масштабируется для соответствия.
  DoubleProperty	fitWidth Определяет ширину ограничивающей области, в которой исходное медиа масштабируется для соответствия.
  ObjectProperty<MediaPlayer>	mediaPlayer mediaPlayer, чьё вывод будет обрабатываться этим просмотром.
  ObjectProperty<EventHandler<MediaErrorEvent>>	onError Обработчик событий об ошибке, который вызывается, когда возникает ошибка в этом MediaView.
  BooleanProperty	preserveRatio Сохранять ли пропорции (ширина/высота) медиа при масштабировании для соответствия узлу.
  BooleanProperty	smooth Если установлено значение true, при масштабировании этого видео для соответствия области, предоставляемой fitWidth и fitHeight, или при преобразовании, будет использоваться алгоритм фильтрации более высокого качества.
  ObjectProperty<Rectangle2D>	viewport Указывает прямоугольный область просмотра в кадре медиа.
  DoubleProperty	x Определяет текущую координату x начала MediaView.
  DoubleProperty	y Определяет текущую координату y начала MediaView.

  • Наследованные свойства от класса javafx.scene.Node

    accessibleHelp, accessibleRoleDescription, accessibleRole, accessibleText, blendMode, boundsInLocal, boundsInParent, cacheHint, cache, clip, cursor, depthTest, disabled, disable, effectiveNodeOrientation, effect, eventDispatcher, focused, focusTraversable, hover, id, inputMethodRequests, layoutBounds, layoutX, layoutY, localToParentTransform, localToSceneTransform, managed, mouseTransparent, nodeOrientation, onContextMenuRequested, onDragDetected, onDragDone, onDragDropped, onDragEntered, onDragExited, onDragOver, onInputMethodTextChanged, onKeyPressed, onKeyReleased, onKeyTyped, onMouseClicked, onMouseDragEntered, onMouseDragExited, onMouseDragged, onMouseDragOver, onMouseDragReleased, onMouseEntered, onMouseExited, onMouseMoved, onMousePressed, onMouseReleased, onRotate, onRotationFinished, onRotationStarted, onScrollFinished, onScroll, onScrollStarted, onSwipeDown, onSwipeLeft, onSwipeRight, onSwipeUp, onTouchMoved, onTouchPressed, onTouchReleased, onTouchStationary, onZoomFinished, onZoom, onZoomStarted, opacity, parent, pickOnBounds, pressed, rotate, rotationAxis, scaleX, scaleY, scaleZ, scene, style, translateX, translateY, translateZ, visible

• Краткое описание полей

  • Поля, унаследованные от класса javafx.scene.Node

    BASELINE_OFFSET_SAME_AS_HEIGHT

• Краткое описание конструкторов

  Конструкторы

  Конструктор и описание
  MediaView() Создаёт экземпляр MediaView без связанного MediaPlayer.
  MediaView(MediaPlayer mediaPlayer) Создаёт экземпляр MediaView, связанный с указанным MediaPlayer.

• Краткое описание методов

  Все методыМетоды экземпляраКонкретные методы

  Модификатор и тип	Метод и описание
  DoubleProperty	fitHeightProperty() Определяет высоту ограничивающей области, в которой исходное медиа масштабируется для соответствия.
  DoubleProperty	fitWidthProperty() Определяет ширину ограничивающей области, в которой исходное медиа масштабируется для соответствия.
  double	getFitHeight() Возвращает высоту ограничивающей области отмасштабированного медиа.
  double	getFitWidth() Возвращает ширину ограничивающей области отмасштабированного медиа.
  MediaPlayer	getMediaPlayer() Возвращает MediaPlayer, чьё вывод обрабатывается этим просмотром.
  EventHandler<MediaErrorEvent>	getOnError() Возвращает обработчик событий об ошибке.
  Rectangle2D	getViewport() Возвращает прямоугольную область просмотра в кадре медиа.
  double	getX() Возвращает координату x начала MediaView.
  double	getY() Возвращает координату y начала MediaView.
  boolean	isPreserveRatio() Возвращает, сохраняются ли пропорции медиа при масштабировании.
  boolean	isSmooth() Возвращает, сглаживать ли медиа при масштабировании.
  ObjectProperty<MediaPlayer>	mediaPlayerProperty() mediaPlayer, чьё вывод обрабатывается этим просмотром.
  ObjectProperty<EventHandler<MediaErrorEvent>>	onErrorProperty() Обработчик событий об ошибке, который вызывается, когда возникает ошибка в этом MediaView.
  BooleanProperty	preserveRatioProperty() Сохранять ли пропорции (ширина / высота) медиа при масштабировании для соответствия узлу.
  void	setFitHeight(double value) Устанавливает высоту ограничивающей области отмасштабированного медиа.
  void	setFitWidth(double value) Устанавливает ширину ограничивающей области отмасштабированного медиа.
  void	setMediaPlayer(MediaPlayer value) Устанавливает MediaPlayer, чьё вывод будет обрабатываться этим просмотром.
  void	setOnError(EventHandler<MediaErrorEvent> value) Устанавливает обработчик событий об ошибке.
  void	setPreserveRatio(boolean value) Устанавливает, сохранять ли пропорции медиа при масштабировании.
  void	setSmooth(boolean value) Устанавливает, сглаживать ли медиа при масштабировании.
  void	setViewport(Rectangle2D value) Устанавливает прямоугольную область просмотра в кадре медиа.
  void	setX(double value) Устанавливает координату x начала MediaView.
  void	setY(double value) Устанавливает координату y начала MediaView.
  BooleanProperty	smoothProperty() Если установлено значение true, при масштабировании этого видео для соответствия области, предоставляемой fitWidth и fitHeight, или при преобразовании, будет использоваться алгоритм фильтрации более высокого качества.
  ObjectProperty<Rectangle2D>	viewportProperty() Устанавливает прямоугольную область просмотра в кадре медиа.
  DoubleProperty	xProperty() Устанавливает текущую координату x начала MediaView.
  DoubleProperty	yProperty() Устанавливает текущую координату y начала MediaView.

  • Унаследованные методы от класса javafx.scene.Node

    accessibleHelpProperty, accessibleRoleDescriptionProperty, accessibleRoleProperty, accessibleTextProperty, addEventFilter, addEventHandler, applyCss, autosize, blendModeProperty, boundsInLocalProperty, boundsInParentProperty, buildEventDispatchChain, cacheHintProperty, cacheProperty, clipProperty, computeAreaInScreen, contains, contains, cursorProperty, depthTestProperty, disabledProperty, disableProperty, effectiveNodeOrientationProperty, effectProperty, eventDispatcherProperty, executeAccessibleAction, fireEvent, focusedProperty, focusTraversableProperty, getAccessibleHelp, getAccessibleRole, getAccessibleRoleDescription, getAccessibleText, getBaselineOffset, getBlendMode, getBoundsInLocal, getBoundsInParent, getCacheHint, getClassCssMetaData, getClip, getContentBias, getCssMetaData, getCursor, getDepthTest, getEffect, getEffectiveNodeOrientation, getEventDispatcher, getId, getInputMethodRequests, getLayoutBounds, getLayoutX, getLayoutY, getLocalToParentTransform, getLocalToSceneTransform, getNodeOrientation, getOnContextMenuRequested, getOnDragDetected, getOnDragDone, getOnDragDropped, getOnDragEntered, getOnDragExited, getOnDragOver, getOnInputMethodTextChanged, getOnKeyPressed, getOnKeyReleased, getOnKeyTyped, getOnMouseClicked, getOnMouseDragEntered, getOnMouseDragExited, getOnMouseDragged, getOnMouseDragOver, getOnMouseDragReleased, getOnMouseEntered, getOnMouseExited, getOnMouseMoved, getOnMousePressed, getOnMouseReleased, getOnRotate, getOnRotationFinished, getOnRotationStarted, getOnScroll, getOnScrollFinished, getOnScrollStarted, getOnSwipeDown, getOnSwipeLeft, getOnSwipeRight, getOnSwipeUp, getOnTouchMoved, getOnTouchPressed, getOnTouchReleased, getOnTouchStationary, getOnZoom, getOnZoomFinished, getOnZoomStarted, getOpacity, getParent, getProperties, getPseudoClassStates, getRotate, getRotationAxis, getScaleX, getScaleY, getScaleZ, getScene, getStyle, getStyleableParent, getStyleClass, getTransforms, getTranslateX, getTranslateY, getTranslateZ, getTypeSelector, getUserData, hasProperties, hoverProperty, idProperty, inputMethodRequestsProperty, intersects, intersects, isCache, isDisable, isDisabled, isFocused, isFocusTraversable, isHover, isManaged, isMouseTransparent, isPickOnBounds, isPressed, isResizable, isVisible, layoutBoundsProperty, layoutXProperty, layoutYProperty, localToParent, localToParent, localToParent, localToParent, localToParent, localToParentTransformProperty, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToSceneTransformProperty, localToScreen, localToScreen, localToScreen, localToScreen, localToScreen, lookup, lookupAll, managedProperty, maxHeight, maxWidth, minHeight, minWidth, mouseTransparentProperty, nodeOrientationProperty, notifyAccessibleAttributeChanged, onContextMenuRequestedProperty, onDragDetectedProperty, onDragDoneProperty, onDragDroppedProperty, onDragEnteredProperty, onDragExitedProperty, onDragOverProperty, onInputMethodTextChangedProperty, onKeyPressedProperty, onKeyReleasedProperty, onKeyTypedProperty, onMouseClickedProperty, onMouseDragEnteredProperty, onMouseDragExitedProperty, onMouseDraggedProperty, onMouseDragOverProperty, onMouseDragReleasedProperty, onMouseEnteredProperty, onMouseExitedProperty, onMouseMovedProperty, onMousePressedProperty, onMouseReleasedProperty, onRotateProperty, onRotationFinishedProperty, onRotationStartedProperty, onScrollFinishedProperty, onScrollProperty, onScrollStartedProperty, onSwipeDownProperty, onSwipeLeftProperty, onSwipeRightProperty, onSwipeUpProperty, onTouchMovedProperty, onTouchPressedProperty, onTouchReleasedProperty, onTouchStationaryProperty, onZoomFinishedProperty, onZoomProperty, onZoomStartedProperty, opacityProperty, parentProperty, parentToLocal, parentToLocal, parentToLocal, parentToLocal, parentToLocal, pickOnBoundsProperty, prefHeight, prefWidth, pressedProperty, pseudoClassStateChanged, queryAccessibleAttribute, relocate, removeEventFilter, removeEventHandler, requestFocus, resize, resizeRelocate, rotateProperty, rotationAxisProperty, scaleXProperty, scaleYProperty, scaleZProperty, sceneProperty, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, screenToLocal, screenToLocal, screenToLocal, setAccessibleHelp, setAccessibleRole, setAccessibleRoleDescription, setAccessibleText, setBlendMode, setCache, setCacheHint, setClip, setCursor, setDepthTest, setDisable, setDisabled, setEffect, setEventDispatcher, setEventHandler, setFocused, setFocusTraversable, setHover, setId, setInputMethodRequests, setLayoutX, setLayoutY, setManaged, setMouseTransparent, setNodeOrientation, setOnContextMenuRequested, setOnDragDetected, setOnDragDone, setOnDragDropped, setOnDragEntered, setOnDragExited, setOnDragOver, setOnInputMethodTextChanged, setOnKeyPressed, setOnKeyReleased, setOnKeyTyped, setOnMouseClicked, setOnMouseDragEntered, setOnMouseDragExited, setOnMouseDragged, setOnMouseDragOver, setOnMouseDragReleased, setOnMouseEntered, setOnMouseExited, setOnMouseMoved, setOnMousePressed, setOnMouseReleased, setOnRotate, setOnRotationFinished, setOnRotationStarted, setOnScroll, setOnScrollFinished, setOnScrollStarted, setOnSwipeDown, setOnSwipeLeft, setOnSwipeRight, setOnSwipeUp, setOnTouchMoved, setOnTouchPressed, setOnTouchReleased, setOnTouchStationary, setOnZoom, setOnZoomFinished, setOnZoomStarted, setOpacity, setPickOnBounds, setPressed, setRotate, setRotationAxis, setScaleX, setScaleY, setScaleZ, setStyle, setTranslateX, setTranslateY, setTranslateZ, setUserData, setVisible, snapshot, snapshot, startDragAndDrop, startFullDrag, styleProperty, toBack, toFront, toString, translateXProperty, translateYProperty, translateZProperty, usesMirroring, visibleProperty

  • Унаследованные методы от класса java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

• Подробности свойства

  • mediaPlayer

    public final ObjectProperty<MediaPlayer> mediaPlayerProperty

    mediaPlayer, вывод которого будет обрабатываться этим представлением. Установка этого значения не влияет на состояние MediaPlayer, например, если MediaPlayer воспроизводился до установки mediaPlayer, то он будет продолжать воспроизводиться.

    См. также:

    getMediaPlayer(), setMediaPlayer(MediaPlayer)

  • onError

    public final ObjectProperty<EventHandler<MediaErrorEvent>> onErrorProperty

    Обработчик событий, который вызывается всякий раз, когда возникает ошибка в этом MediaView.

    См. также:

    getOnError(), setOnError(EventHandler)

  • preserveRatio

    public final BooleanProperty preserveRatioProperty

    Сохранять ли соотношение сторон (ширина / высота) медиа при масштабировании для соответствия узлу. Если соотношение сторон не сохраняется, медиа будет растянуто или сжато по обеим осям для соответствия размерам узла. Значение по умолчанию — true.

    См. также:

    isPreserveRatio(), setPreserveRatio(boolean)

  • smooth

    public final BooleanProperty smoothProperty

    Если установлено true, при масштабировании этого видео для вписывания в область, заданную fitWidth и fitHeight, или при преобразовании будет использоваться алгоритм фильтрации лучшего качества. Если установлено false, будет использоваться более быстрый, но менее качественный алгоритм фильтрации. Значение по умолчанию зависит от конфигурации платформы.

    См. также:

    isSmooth(), setSmooth(boolean)

  • x

    public final DoubleProperty xProperty

    Определяет текущую координату x начала MediaView.

    См. также:

    getX(), setX(double)

  • y

    public final DoubleProperty yProperty

    Определяет текущую координату y начала MediaView.

    См. также:

    getY(), setY(double)

  • fitWidth

    public final DoubleProperty fitWidthProperty

    Определяет ширину области, в которой исходное медиа масштабируется по мере необходимости для вписывания. Если value ≤ 0, ширина области будет установлена в естественную ширину медиа, но fitWidth будет установлено в переданный параметр, даже если он не положителен. См. preserveRatio для информации о взаимодействии между медиапредставлениями fitWidth, fitHeight и preserveRatio атрибутами.

    См. также:

    getFitWidth(), setFitWidth(double)

  • fitHeight

    public final DoubleProperty fitHeightProperty

    Определяет высоту области, в которой исходное медиа масштабируется по мере необходимости для вписывания. Если value ≤ 0, высота области будет установлена в естественную высоту медиа, но fitHeight будет установлено в переданный параметр, даже если он не положителен. См. preserveRatio для информации о взаимодействии между медиапредставлениями fitWidth, fitHeight и preserveRatio атрибутами.

    См. также:

    getFitHeight(), setFitHeight(double)

  • viewport

    public final ObjectProperty<Rectangle2D> viewportProperty

    Указывает прямоугольное область просмотра в кадре медиа. Область просмотра — это прямоугольник, заданный в координатах кадра медиа. Результирующие границы до масштабирования будут размером области просмотра. Отображаемое изображение будет включать пересечение кадра и области просмотра. Область просмотра может превышать размер кадра, но будет отображено только пересечение. Установка viewport в значение null очистит область просмотра.

    См. также:

    getViewport(), setViewport(Rectangle2D)

• Подробности конструктора

  • MediaView

    public MediaView()

    Создаёт экземпляр MediaView без связанного MediaPlayer.

  • MediaView

    public MediaView(MediaPlayer mediaPlayer)

    Создаёт экземпляр MediaView, связанный с указанным MediaPlayer. Эквивалентно

    MediaPlayer player; // initialization omitted
     MediaView view = new MediaView();
     view.setPlayer(player);

    Параметры:

    mediaPlayer — MediaPlayer, воспроизведение которого должно отображаться с помощью этого класса.

• Подробное описание методов

  • setMediaPlayer

    public final void setMediaPlayer(MediaPlayer value)

    Устанавливает MediaPlayer, чьи выводы будут обрабатываться этим представлением.

    Параметры:

    value — связанное MediaPlayer.

  • getMediaPlayer

    public final MediaPlayer getMediaPlayer()

    Возвращает MediaPlayer, чьи выводы обрабатываются этим представлением.

    Возвращаемое значение:

    связанное MediaPlayer.

  • mediaPlayerProperty

    public final ObjectProperty<MediaPlayer> mediaPlayerProperty()

    mediaPlayer, чьи выводы будут обрабатываться этим представлением. Установка этого значения не влияет на состояние MediaPlayer, например, если MediaPlayer воспроизводился до установки mediaPlayer, он продолжит воспроизведение.

    См. также:

    getMediaPlayer(), setMediaPlayer(MediaPlayer)

  • setOnError

    public final void setOnError(EventHandler<MediaErrorEvent> value)

    Устанавливает обработчик ошибок.

    Параметры:

    value — обработчик ошибок.

  • getOnError

    public final EventHandler<MediaErrorEvent> getOnError()

    Возвращает обработчик ошибок.

    Возвращаемое значение:

    обработчик ошибок.

  • onErrorProperty

    public final ObjectProperty<EventHandler<MediaErrorEvent>> onErrorProperty()

    Обработчик событий, который вызывается всякий раз, когда возникает ошибка в этом MediaView.

    См. также:

    getOnError(), setOnError(EventHandler)

  • setPreserveRatio

    public final void setPreserveRatio(boolean value)

    Устанавливает, сохранять ли соотношение сторон медиа при масштабировании.

    Параметры:

    value — сохранять ли соотношение сторон медиа.

  • isPreserveRatio

    public final boolean isPreserveRatio()

    Возвращает, сохраняется ли соотношение сторон медиа при масштабировании.

    Возвращаемое значение:

    сохраняется ли соотношение сторон медиа.

  • preserveRatioProperty

    public final BooleanProperty preserveRatioProperty()

    Сохранять ли соотношение сторон (ширина/высота) медиа при масштабировании до размера узла. Если соотношение сторон не сохраняется, медиа будет растянуто или сжато по обеим осям, чтобы соответствовать размерам узла. Значение по умолчанию — true.

    См. также:

    isPreserveRatio(), setPreserveRatio(boolean)

  • setSmooth

    public final void setSmooth(boolean value)

    Устанавливает, сглаживать ли медиа при масштабировании.

    Параметры:

    value — сглаживать ли медиа.

  • isSmooth

    public final boolean isSmooth()

    Возвращает, сглаживается ли медиа при масштабировании.

    Возвращаемое значение:

    сглаживать ли медиа

  • smoothProperty

    public final BooleanProperty smoothProperty()

    Если установлено в true, будет использован алгоритм фильтрации лучшего качества при масштабировании этого видео для соответствия границам, заданным fitWidth и fitHeight, или при преобразованиях. Если установлено в false, будет использован более быстрый, но менее качественный алгоритм фильтрации. Значение по умолчанию зависит от конфигурации платформы.

    См. также:

    isSmooth(), setSmooth(boolean)

  • setX

    public final void setX(double value)

    Устанавливает координату x начала MediaView.

    Параметры:

    value — координата x начала представления.

  • getX

    public final double getX()

    Возвращает координату x начала MediaView.

    Возвращаемое значение:

    координата x начала представления.

  • xProperty

    public final DoubleProperty xProperty()

    Определяет текущую координату x начала MediaView.

    См. также:

    getX(), setX(double)

  • setY

    public final void setY(double value)

    Устанавливает координату y начала MediaView.

    Параметры:

    value — координата y начала представления.

  • getY

    public final double getY()

    Возвращает координату y начала MediaView.

    Возвращаемое значение:

    координата y начала представления.

  • yProperty

    public final DoubleProperty yProperty()

    Определяет текущую координату y начала MediaView.

    См. также:

    getY(), setY(double)

  • setFitWidth

    public final void setFitWidth(double value)

    Устанавливает ширину области отображения измененного медиа.

    Параметры:

    value — ширина измененного медиа.

  • getFitWidth

    public final double getFitWidth()

    Возвращает ширину области отображения измененного медиа.

    Возвращаемое значение:

    высота измененного медиа.

  • fitWidthProperty

    public final DoubleProperty fitWidthProperty()

    Определяет ширину области отображения, в которой исходное медиа масштабируется для соответствия. Если value ≤ 0, тогда ширина области отображения будет установлена в естественную ширину медиа, но fitWidth будет установлено в переданный параметр, даже если он неположительный. См. preserveRatio для информации о взаимодействии медиапредставлений fitWidth, fitHeight и preserveRatio.

    См. также:

    getFitWidth(), setFitWidth(double)

  • setFitHeight

    public final void setFitHeight(double value)

    Устанавливает высоту области отображения измененного медиа.

    Параметры:

    value — высота измененного медиа.

  • getFitHeight

    public final double getFitHeight()

    Возвращает высоту области отображения измененного медиа.

    Возвращаемое значение:

    высота измененного медиа.

  • fitHeightProperty

    public final DoubleProperty fitHeightProperty()

    Определяет высоту области отображения, в которой исходное медиа масштабируется для соответствия. Если value ≤ 0, тогда высота области отображения будет установлена в естественную высоту медиа, но fitHeight будет установлено в переданный параметр, даже если он неположительный. См. preserveRatio для информации о взаимодействии медиапредставлений fitWidth, fitHeight и preserveRatio.

    См. также:

    getFitHeight(), setFitHeight(double)

  • setViewport

    public final void setViewport(Rectangle2D value)

    Устанавливает прямоугольное представление в рамку медиа.

    Параметры:

    value — прямоугольное представление.

  • getViewport

    public final Rectangle2D getViewport()

    Возвращает прямоугольное представление в рамке медиа.

    Возвращаемое значение:

    прямоугольное представление.

  • viewportProperty

    public final ObjectProperty<Rectangle2D> viewportProperty()

    Определяет прямоугольное представление в рамке медиа. Представление — прямоугольник, заданный в координатах рамки медиа. Результирующие границы до масштабирования будут размерами представления. Отображаемый образ будет включать пересечение рамки и представления. Представление может превышать размеры рамки, но будет отображаться только область пересечения. Установка viewport в null очистит представление.

    См. также:

    getViewport(), setViewport(Rectangle2D)