1 /* 2 * Copyright (c) 2013, Oracle and/or its affiliates. All rights reserved. 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 4 * 5 * This code is free software; you can redistribute it and/or modify it 6 * under the terms of the GNU General Public License version 2 only, as 7 * published by the Free Software Foundation. Oracle designates this 8 * particular file as subject to the "Classpath" exception as provided 9 * by Oracle in the LICENSE file that accompanied this code. 10 * 11 * This code is distributed in the hope that it will be useful, but WITHOUT 12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 14 * version 2 for more details (a copy is included in the LICENSE file that 15 * accompanied this code). 16 * 17 * You should have received a copy of the GNU General Public License version 18 * 2 along with this work; if not, write to the Free Software Foundation, 19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 20 * 21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 22 * or visit www.oracle.com if you need additional information or have any 23 * questions. 24 */ 25 26 package javafx.scene.paint; 27 28 import com.sun.javafx.sg.prism.NGPhongMaterial; 29 import javafx.application.ConditionalFeature; 30 import javafx.application.Platform; 31 import javafx.beans.property.BooleanProperty; 32 import javafx.beans.property.SimpleBooleanProperty; 33 import sun.util.logging.PlatformLogger; 34 35 /** 36 * Base class for representing the material of a 3D surface. 37 * 38 * Note that this is a conditional feature. See 39 * {@link javafx.application.ConditionalFeature#SCENE3D ConditionalFeature.SCENE3D} 40 * for more information. 41 * 42 * @since JavaFX 8.0 43 */ 44 public abstract class Material { 45 /* 46 * Material (including Shaders and Textures) 47 Material is not Paint 48 PhongMaterial maybe the first and only material in FX8 (see 3D conceptual implementation for details) 49 Bump map: Normal Map and Height Map -- We may generate a Normal Map when given a Height Map 50 Displacement map? Not in FX8 -- May do Parallex correction mapping to improve quality at performance cost 51 Support auto generated Mipmap 52 No plan to support Multi-texture 53 */ 54 55 protected Material() { 56 if (!Platform.isSupported(ConditionalFeature.SCENE3D)) { 57 String logname = Material.class.getName(); 58 PlatformLogger.getLogger(logname).warning("System can't support " 59 + "ConditionalFeature.SCENE3D"); 60 } 61 } 62 63 // Material isn't a Node. It can't use the standard dirtyBits pattern that is 64 // in Node 65 private final BooleanProperty dirty = new SimpleBooleanProperty(true); 66 67 final boolean isDirty() { 68 return dirty.getValue(); 69 } 70 71 void setDirty(boolean value) { 72 dirty.setValue(value); 73 } 74 75 /** 76 * @treatAsPrivate implementation detail 77 * @deprecated This is an internal API that is not intended for use and will be removed in the next version 78 */ 79 @Deprecated 80 public final BooleanProperty impl_dirtyProperty() { 81 return dirty; 82 } 83 84 /** 85 * @treatAsPrivate implementation detail 86 * @deprecated This is an internal API that is not intended for use and will be removed in the next version 87 */ 88 @Deprecated 89 abstract public void impl_updatePG(); 90 91 /** 92 * @treatAsPrivate implementation detail 93 * @deprecated This is an internal API that is not intended for use and will be removed in the next version 94 */ 95 @Deprecated 96 abstract public NGPhongMaterial impl_getNGMaterial(); 97 } | 1 /* 2 * Copyright (c) 2013, 2016, Oracle and/or its affiliates. All rights reserved. 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 4 * 5 * This code is free software; you can redistribute it and/or modify it 6 * under the terms of the GNU General Public License version 2 only, as 7 * published by the Free Software Foundation. Oracle designates this 8 * particular file as subject to the "Classpath" exception as provided 9 * by Oracle in the LICENSE file that accompanied this code. 10 * 11 * This code is distributed in the hope that it will be useful, but WITHOUT 12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 14 * version 2 for more details (a copy is included in the LICENSE file that 15 * accompanied this code). 16 * 17 * You should have received a copy of the GNU General Public License version 18 * 2 along with this work; if not, write to the Free Software Foundation, 19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 20 * 21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 22 * or visit www.oracle.com if you need additional information or have any 23 * questions. 24 */ 25 26 package javafx.scene.paint; 27 28 import com.sun.javafx.scene.paint.MaterialHelper; 29 import com.sun.javafx.sg.prism.NGPhongMaterial; 30 import javafx.application.ConditionalFeature; 31 import javafx.application.Platform; 32 import javafx.beans.property.BooleanProperty; 33 import javafx.beans.property.SimpleBooleanProperty; 34 import sun.util.logging.PlatformLogger; 35 36 /** 37 * Base class for representing the material of a 3D surface. 38 * 39 * Note that this is a conditional feature. See 40 * {@link javafx.application.ConditionalFeature#SCENE3D ConditionalFeature.SCENE3D} 41 * for more information. 42 * 43 * @since JavaFX 8.0 44 */ 45 public abstract class Material { 46 47 static { 48 // This is used by classes in different packages to get access to 49 // private and package private methods. 50 MaterialHelper.setMaterialAccessor(new MaterialHelper.MaterialAccessor() { 51 52 @Override 53 public BooleanProperty dirtyProperty(Material material) { 54 return material.dirtyProperty(); 55 } 56 57 @Override 58 public void updatePG(Material material) { 59 material.updatePG(); 60 } 61 @Override 62 public NGPhongMaterial getNGMaterial(Material material) { 63 return material.getNGMaterial(); 64 } 65 66 }); 67 } 68 69 /* 70 * Material (including Shaders and Textures) 71 Material is not Paint 72 PhongMaterial maybe the first and only material in FX8 (see 3D conceptual implementation for details) 73 Bump map: Normal Map and Height Map -- We may generate a Normal Map when given a Height Map 74 Displacement map? Not in FX8 -- May do Parallex correction mapping to improve quality at performance cost 75 Support auto generated Mipmap 76 No plan to support Multi-texture 77 */ 78 79 protected Material() { 80 if (!Platform.isSupported(ConditionalFeature.SCENE3D)) { 81 String logname = Material.class.getName(); 82 PlatformLogger.getLogger(logname).warning("System can't support " 83 + "ConditionalFeature.SCENE3D"); 84 } 85 } 86 87 // Material isn't a Node. It can't use the standard dirtyBits pattern that is 88 // in Node 89 private final BooleanProperty dirty = new SimpleBooleanProperty(true); 90 91 final boolean isDirty() { 92 return dirty.getValue(); 93 } 94 95 void setDirty(boolean value) { 96 dirty.setValue(value); 97 } 98 99 private final BooleanProperty dirtyProperty() { 100 return dirty; 101 } 102 103 abstract void updatePG(); 104 105 abstract NGPhongMaterial getNGMaterial(); 106 } |