Класс PerspectiveCamera

java.lang.Object

javafx.scene.Node

javafx.scene.Camera

javafx.scene.PerspectiveCamera

Все реализованные интерфейсы:: Styleable, EventTarget

public non-sealed class PerspectiveCamera extends Camera

Определяет перспективную камеру для рендеринга сцены.

Эта камера определяет объём обзора для перспективной проекции; усечённая прямая пирамида. Значение fieldOfView может быть использовано для изменения объёма обзора. По умолчанию эта камера расположена в центре сцены и смотрит вдоль положительной оси Z. Система координат, определяемая этой камерой, имеет свой начало в верхнем левом углу панели, ось Y направлена вниз, а ось Z — от наблюдателя (внутрь экрана). Если узел PerspectiveCamera добавлен в граф сцены, преобразованное положение и ориентация камеры определят положение камеры и направление взгляда камеры.

В камере по умолчанию, где fixedEyeAtCameraZero — false, значение Z позиции глаза корректируется таким образом, чтобы матрица проекции, сгенерированная с использованием указанного fieldOfView, давала единицы в Z = 0 (плоскость проекции), в устройствах независимых пикселях, соответствует ParallelCamera. При изменении размера сцены объекты в сцене на плоскости проекции (Z = 0) останутся одинакового размера, но больше или меньше содержимого сцены будет видно.

Если fixedEyeAtCameraZero — true, позиция глаза фиксируется в (0, 0, 0) в локальных координатах камеры. Матрица проекции генерируется с использованием указанного fieldOfView, а объём проекции отображается на область просмотра (окно) таким образом, что он растягивается на большее или меньшее количество устройств независимых пикселей на плоскости проекции. При изменении размера сцены объекты в сцене будут уменьшаться или увеличиваться пропорционально, но видимая часть содержимого не изменится.

Рекомендуется устанавливать fixedEyeAtCameraZero в значение true, если вы собираетесь преобразовывать (перемещать) камеру. Преобразование камеры, когда fixedEyeAtCameraZero установлено в значение false, может привести к результатам, которые не интуитивны.

Обратите внимание, что это условная функция. См. ConditionalFeature.SCENE3D для получения дополнительной информации.

С:: JavaFX 2.0

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

Тип	Свойство	Описание
`final DoubleProperty`	`fieldOfView`	Указывает угол поля зрения камеры в градусах.
`final BooleanProperty`	`verticalFieldOfView`	Определяет, будет ли свойство `fieldOfView` применяться к вертикальному измерению проекции.

Свойства, объявленные в классе javafx.scene.Camera

farClip, nearClip

Свойства, объявленные в классе javafx.scene.Node

accessibleHelp, accessibleRoleDescription, accessibleRole, accessibleText, blendMode, boundsInLocal, boundsInParent, cacheHint, cache, clip, cursor, depthTest, disabled, disable, effectiveNodeOrientation, effect, eventDispatcher, focused, focusTraversable, focusVisible, focusWithin, 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, viewOrder, visible

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

Поля, объявленные в классе javafx.scene.Node

BASELINE_OFFSET_SAME_AS_HEIGHT

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

Конструктор	Описание
`PerspectiveCamera()`	Создаёт пустой экземпляр PerspectiveCamera.
`PerspectiveCamera(boolean fixedEyeAtCameraZero)`	Создаёт PerspectiveCamera с указанным флагом fixedEyeAtCameraZero.

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

Модификатор и тип	Метод	Описание
`final DoubleProperty`	`fieldOfViewProperty()`	Указывает угол поля зрения камеры в градусах.
`final double`	`getFieldOfView()`	Возвращает значение свойства `fieldOfView`.
`final boolean`	`isFixedEyeAtCameraZero()`	Возвращает флаг, указывающий, использует ли эта камера фиксированную позицию глаза в начале координат камеры.
`final boolean`	`isVerticalFieldOfView()`	Возвращает значение свойства `verticalFieldOfView`.
`final void`	`setFieldOfView(double value)`	Устанавливает значение свойства `fieldOfView`.
`final void`	`setVerticalFieldOfView(boolean value)`	Устанавливает значение свойства `verticalFieldOfView`.
`final BooleanProperty`	`verticalFieldOfViewProperty()`	Определяет, будет ли свойство `fieldOfView` применяться к вертикальному измерению проекции.

Методы, объявленные в классе javafx.scene.Camera

farClipProperty, getFarClip, getNearClip, nearClipProperty, setFarClip, setNearClip

Методы, объявленные в классе 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, focusVisibleProperty, focusWithinProperty, getAccessibleHelp, getAccessibleRole, getAccessibleRoleDescription, getAccessibleText, getBaselineOffset, getBlendMode, getBoundsInLocal, getBoundsInParent, getCacheHint, getClassCssMetaData, getClip, getContentBias, getCssMetaData, getCursor, getDepthTest, getEffect, getEffectiveNodeOrientation, getEventDispatcher, getId, getInitialCursor, getInitialFocusTraversable, 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, getViewOrder, hasProperties, hoverProperty, idProperty, inputMethodRequestsProperty, intersects, intersects, isCache, isDisable, isDisabled, isFocused, isFocusTraversable, isFocusVisible, isFocusWithin, 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, requestFocusTraversal, 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, setViewOrder, setVisible, snapshot, snapshot, startDragAndDrop, startFullDrag, styleProperty, toBack, toFront, toString, translateXProperty, translateYProperty, translateZProperty, usesMirroring, viewOrderProperty, visibleProperty

Методы, объявленные в классе java.lang.Object

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

Методы, объявленные в интерфейсе javafx.css.Styleable

getStyleableNode

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

fieldOfView

public final DoubleProperty fieldOfViewProperty

Указывает угол обзора проекции камеры в градусах.

Значение по умолчанию:

30.0

См. также:

verticalFieldOfView

public final BooleanProperty verticalFieldOfViewProperty

Определяет, будет ли свойство fieldOfView применяться к вертикальному измерению проекции. Если false, fieldOfView будет применяться к горизонтальному измерению проекции.

Значение по умолчанию:

true

С момента:

JavaFX 8.0

См. также:

Подробное описание конструкторов

PerspectiveCamera

public PerspectiveCamera()

Создаёт пустой экземпляр PerspectiveCamera.

PerspectiveCamera

public PerspectiveCamera(boolean fixedEyeAtCameraZero)

Конструирует PerspectiveCamera с указанным флагом fixedEyeAtCameraZero.

В стандартной камере, где fixedEyeAtCameraZero равен false, значение Z позиции глаза корректируется таким образом, что матрица проекции, сгенерированная с использованием указанного fieldOfView, даёт единицы в Z = 0 (плоскость проекции), в независимых от устройства пикселях, совпадающих с ParallelCamera. При изменении размера сцены объекты в сцене на плоскости проекции (Z = 0) сохранят размер, но более или менее содержимого сцены будет видно.

Если fixedEyeAtCameraZero равен true, положение глаза фиксируется в (0, 0, 0) в локальных координатах камеры. Матрица проекции генерируется с использованием указанного fieldOfView, а объём проекции отображается на область просмотра (окно) таким образом, что он растягивается на большее или меньшее количество независимых от устройства пикселей на плоскости проекции. При изменении размера сцены объекты в сцене будут уменьшаться или увеличиваться пропорционально, но видимая часть содержимого останется неизменной.

Рекомендуется устанавливать fixedEyeAtCameraZero в true, если вы собираетесь преобразовывать (перемещать) камеру. Преобразование камеры, когда fixedEyeAtCameraZero установлен в false, может привести к неинтуитивным результатам.

Параметры:: fixedEyeAtCameraZero - true, если положение глаза фиксируется в (0, 0, 0) в локальных координатах камеры.
С момента:: JavaFX 8.0

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

setFieldOfView

public final void setFieldOfView(double value)

Устанавливает значение свойства fieldOfView.

Описание свойства:

Указывает угол обзора проекции камеры в градусах.

Значение по умолчанию:

30.0

Параметры:

value - значение для свойства fieldOfView

См. также:

getFieldOfView

public final double getFieldOfView()

Получает значение свойства fieldOfView.

Описание свойства:

Указывает угол обзора проекции камеры в градусах.

Значение по умолчанию:

30.0

Возвращает:

значение свойства fieldOfView

См. также:

fieldOfViewProperty

public final DoubleProperty fieldOfViewProperty()

Указывает угол обзора проекции камеры в градусах.

Значение по умолчанию:

30.0

Возвращает:

свойство fieldOfView

См. также:

setVerticalFieldOfView

public final void setVerticalFieldOfView(boolean value)

Устанавливает значение свойства verticalFieldOfView.

Описание свойства:

Значение по умолчанию:

true

Параметры:

value - значение для свойства verticalFieldOfView

С момента:

JavaFX 8.0

См. также:

isVerticalFieldOfView

public final boolean isVerticalFieldOfView()

Получает значение свойства verticalFieldOfView.

Описание свойства:

Значение по умолчанию:

true

Возвращает:

значение свойства verticalFieldOfView

С момента:

JavaFX 8.0

См. также:

verticalFieldOfViewProperty

public final BooleanProperty verticalFieldOfViewProperty()

Значение по умолчанию:

true

Возвращает:

свойство verticalFieldOfView

С момента:

JavaFX 8.0

См. также:

isFixedEyeAtCameraZero

public final boolean isFixedEyeAtCameraZero()

Возвращает флаг, указывающий, использует ли эта камера фиксированное положение глаза в начале координат камеры. Если fixedEyeAtCameraZero равно true, положение глаза фиксируется в (0, 0, 0) в локальных координатах камеры. Это свойство неизменяемо.

Возвращает:: флаг, указывающий, использует ли эта камера фиксированное положение глаза в начале координат камеры
С момента:: JavaFX 8.0

© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.