scene graph
一张呈现为树结构的数据结构,java fx 的渲染系统 是通过该数据结构来完成图形的渲染。
所有在树结构的每一个节点称为一个node
根节点(root)是唯一一个没有父母节点的node
没有子节点的node的称为leaf node(叶子节点)
1 . 在scene graph中的每一个node,都有自己的笛卡尔坐标系
Paste_Image.png
2 . 每个node 的视图“呈现”除了几何图形外,其实还包括effect(特效),clip(裁剪),transformation(变换)等特性
3 . Fx 针对每个node 对所包含的特性,提供了不同bound框来囊括这些特性,不同bound的范围
layoutBounds : node geometry
boundsInLocal: node geometry + effects + clip
boundsInParent: node geometry + effects + clip + transformations
Paste_Image.png
public class BoundTest extends Application {
public static void main(String[] args) {
Application.launch(args);
}
@Override
public void start(Stage primaryStage) throws Exception {
VBox root = new VBox();
Scene scene = new Scene(root);
primaryStage.setScene(scene);
// 1. only a simple button
System.out.println("only a simple button");
Button button1 = new Button();
System.out.println("button1=" + button1.getLayoutBounds());
System.out.println("button1=" + button1.getBoundsInLocal());
System.out.println("button1=" + button1.getBoundsInParent());
System.out.println();
System.out.println("add shadow");
// 2. add shadow
Button button2 = new Button();
button2.setEffect(new BoxBlur());
System.out.println("button2=" + button2.getLayoutBounds());
System.out.println("button2=" + button2.getBoundsInLocal());
System.out.println("button2=" + button2.getBoundsInParent());
System.out.println();
System.out.println("add transformation");
// 3. add transformation
Button button3 = new Button();
//button3.setRotate(60);
button3.getTransforms().add(new Translate(150, 75));
System.out.println("button3=" + button3.getLayoutBounds());
System.out.println("button3=" + button3.getBoundsInLocal());
System.out.println("button3=" + button3.getBoundsInParent());
root.getChildren().addAll(button1, new Group(button2), button3);
//primaryStage.show();
}
}
4 . 别名
Layout Bounds: 逻辑bound(logic bound)
BoundsInLocal: 现实上的bound(physical bound) (希望当前node包含Effect,Clip时候用的,另一种情况检测两个node有无碰撞)
BoundsInParent: 虚幻的bound(visual bound) (较少在code中使用到)
5 .这些Bound 处于不同的坐标系中
Layout Bounds: 在该node 的坐标系
BoundsInLocas:在该node 的坐标系
BoundsInParent:在该node 的parent的坐标系
了解这些不同的Bounds
6 . 每一个node 都有一对LayoutX和LayoutY以及一对translateX和translateY 来描述他们在坐标系中的位置
LayoutX 和LayoutY : 固定(stable) layout
translateX和translateY: 动态(dynamic) layout (animaiton中)
finalTranslationX = layoutX + translateX
finalTranslationY = layoutY + translateY
但是layoutX and layoutY 并不是就是直接确定了node的位置,它通常需要转为node的坐标系中的位置,通常需要补偿一个layoutBound.minX和layoutBound.minY
layoutX = finalX - node.getLayoutBounds().getMinX();
layoutY = finalY - node.getLayoutBounds().getMinY();
7 . 由于Bound 的存在,当你想设置坐标时候,记得加上边框左上角的位置的横纵坐标,推荐使用relocate() ,它会帮你补偿minX 和minY of layoutBound,自动完成6中提到的转换
8 . 当Parenty 为region 类时候,父节点有自己的位置策略,这时候忽略node layoutX,layoutY. 事实上只有当你的parent节点(layout manager)为Group或着Pane的时候,通过修改layoutX以及layoutY才能修改Node的位置
Node 的Size
当一个node可以随着父节点layout的调整自己的大小,该节点就是可以resize的.Node 的分为resizable和non-resize node.
re-sizable node: Regions, Controls, andWebView
non-resizable node : Group, Text, and Shapes
三个“大小”
Preferred size 最合适大小,当layout 足够满足的时候呈现的size
Minimum size 最小的大小,当resize的时候的最小大小
Maximum size 最大的大小, 当resize的时候的最大大小
对着三个size可以设置两个常量,
USE_COMPUTED_SIZE :依据的node的内容和属性计算
USE_PREF_SIZE:通常用来设置Minimum size和Maximum size保持和Preferred size一致
每个node也有6个属性来对应这个三个特性,这些属性的默认值为:USE_COMPUTED_SIZE
prefWidth,prefHeight
minWidth,minHeight
maxWidth,maxHeight
不要相信getXXX(getMaxWidth,getMinWidth,getPre...),通常这些方法返回的值并没有真实反映node的大小
使用以下方法:
double prefWidth(double height)
double prefHeight(double width)
double minWidth(double height)
double minHeight(double width)
double maxWidth(double height)
double maxHeight(double width)
通过传入-1来获得content bias 边的长度,再根据该长度算得相应的宽或者高
Paste_Image.png
public class NodeSizes extends Application {
public static void main(String[] args) {
Application.launch(args);
}
@Override
public void start(Stage stage) {
Button btn = new Button("Hello JavaFX!");
HBox root = new HBox();
root.getChildren().addAll(btn);
Scene scene = new Scene(root);
stage.setScene(scene);
stage.setTitle("Sizes of a Node");
stage.show();
// Print button's sizes
System.out.println("Before changing button properties:");
printSizes(btn);
// Change button's properties
btn.setWrapText(true);
btn.setPrefWidth(80);
stage.sizeToScene();
// Print button's sizes
System.out.println("\nAfter changing button properties:");
printSizes(btn);
}
public void printSizes(Button btn) {
System.out.println("btn.getContentBias() = " + btn.getContentBias());
System.out.println("btn.getPrefWidth() = " + btn.getPrefWidth() +
", btn.getPrefHeight() = " + btn.getPrefHeight());
System.out.println("btn.getMinWidth() = " + btn.getMinWidth() +
", btn.getMinHeight() = " + btn.getMinHeight());
System.out.println("btn.getMaxWidth() = " + btn.getMaxWidth() +
", btn.getMaxHeight() = " + btn.getMaxHeight());
double prefWidth = btn.prefWidth(-1);
System.out.println("btn.prefWidth(-1) = " + prefWidth +
", btn.prefHeight(prefWidth) = " + btn.prefHeight(prefWidth));
double minWidth = btn.minWidth(-1);
System.out.println("btn.minWidth(-1) = " + minWidth +
", btn.minHeight(minWidth) = " + btn.minHeight(minWidth));
double maxWidth = btn.maxWidth(-1);
System.out.println("btn.maxWidth(-1) = " + maxWidth +
", btn.maxHeight(maxWidth) = " + btn.maxHeight(maxWidth));
System.out.println("btn.getWidth() = " + btn.getWidth() +
", btn.getHeight() = " + btn.getHeight());
}
}
7 对于non-resizable node
prefWidth(double h), minWidth(double h), maxWidth(double h) 返回layoutBound的width
prefHeight(double w), minHeight(double w), maxHeight(double w) 返回layoutBound的height
8 关于managed node
当子节点的managedProperty设置为false的时候,父节点在layout布局的时候,就不会帮把计算如layoutboundbox. 这与visibleProperty的区别,尽管它不可见,父节点仍考虑它的布局。
public class SlidingLeftNodeTest extends Application {
public static void main(String[] args) {
Application.launch(args);
}
@Override
public void start(Stage stage) {
Button b1 = new Button("B1");
Button b2 = new Button("B2");
Button b3 = new Button("B3");
Button visibleBtn = new Button("Make Invisible");
// Add an action listener to the button to make b2 visible
// if it is invisible and invisible if it is visible
visibleBtn.setOnAction(e -> b2.setVisible(!b2.isVisible()));
// Bind the text property of the button to the visible
// property of the b2 button
visibleBtn.textProperty().bind(new When(b2.visibleProperty()).then("Make Invisible").otherwise("Make Visible"));
b2.managedProperty().bind(b2.visibleProperty());
HBox root = new HBox();
root.getChildren().addAll(visibleBtn, b1, b2, b3);
Scene scene = new Scene(root);
stage.setScene(scene);
stage.setTitle("Sliding to the Left");
stage.show();
}
}