Initial commit

This commit is contained in:
Romain Guy
2018-08-03 10:38:22 -07:00
commit b3d758f3b3
8873 changed files with 3023907 additions and 0 deletions
+129
View File
@@ -0,0 +1,129 @@
cmake_minimum_required(VERSION 3.4.1)
project(filament-java)
# ==================================================================================================
# JNI bindings
# ==================================================================================================
set(TARGET filament-jni)
find_package(JNI REQUIRED)
include_directories(${JNI_INCLUDE_DIRS})
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++14")
set(FILAMENT_DIR ../android/filament-android)
set(JNI_SOURCE_FILES
${FILAMENT_DIR}/src/main/cpp/Camera.cpp
${FILAMENT_DIR}/src/main/cpp/Colors.cpp
${FILAMENT_DIR}/src/main/cpp/VertexBuffer.cpp
${FILAMENT_DIR}/src/main/cpp/Engine.cpp
${FILAMENT_DIR}/src/main/cpp/EntityManager.cpp
${FILAMENT_DIR}/src/main/cpp/Fence.cpp
${FILAMENT_DIR}/src/main/cpp/IndexBuffer.cpp
${FILAMENT_DIR}/src/main/cpp/IndirectLight.cpp
${FILAMENT_DIR}/src/main/cpp/LightManager.cpp
${FILAMENT_DIR}/src/main/cpp/Material.cpp
${FILAMENT_DIR}/src/main/cpp/MaterialInstance.cpp
${FILAMENT_DIR}/src/main/cpp/NativeSurface.cpp
${FILAMENT_DIR}/src/main/cpp/RenderableManager.cpp
${FILAMENT_DIR}/src/main/cpp/Renderer.cpp
${FILAMENT_DIR}/src/main/cpp/Scene.cpp
${FILAMENT_DIR}/src/main/cpp/SkyBox.cpp
${FILAMENT_DIR}/src/main/cpp/Stream.cpp
${FILAMENT_DIR}/src/main/cpp/Texture.cpp
${FILAMENT_DIR}/src/main/cpp/TextureSampler.cpp
${FILAMENT_DIR}/src/main/cpp/TransformManager.cpp
${FILAMENT_DIR}/src/main/cpp/View.cpp
# Private utils
${FILAMENT_DIR}/src/main/cpp/CallbackUtils.cpp
${FILAMENT_DIR}/src/main/cpp/Filament.cpp
${FILAMENT_DIR}/src/main/cpp/NioUtils.cpp
# Desktop specific
${FILAMENT_DIR}/src/main/cpp/nativewindow/JAWTUtils.cpp
)
if (LINUX)
list(APPEND JNI_SOURCE_FILES ${FILAMENT_DIR}/src/main/cpp/nativewindow/Linux.cpp)
endif()
if (WIN32)
list(APPEND JNI_SOURCE_FILES ${FILAMENT_DIR}/src/main/cpp/nativewindow/Win32.cpp)
endif()
if (APPLE)
list(APPEND JNI_SOURCE_FILES ${FILAMENT_DIR}/src/main/cpp/nativewindow/Darwin.mm)
endif()
add_library(${TARGET} SHARED ${JNI_SOURCE_FILES})
find_package(JNI)
if (NOT JNI_FOUND)
message(FATAL_ERROR "Unable to find JNI")
endif()
target_link_libraries(${TARGET} filament ${JAVA_AWT_LIBRARY})
set(INSTALL_TYPE LIBRARY)
if (WIN32 OR CYGWIN)
set(INSTALL_TYPE RUNTIME)
endif()
install(TARGETS ${TARGET} ${INSTALL_TYPE} DESTINATION lib/${DIST_DIR})
set(LIB_SUFFIX ".so")
if (APPLE)
set(LIB_SUFFIX ".dylib")
elseif (WIN32)
set(LIB_SUFFIX ".dll")
endif()
install(CODE "execute_process(COMMAND ${CMAKE_STRIP} -x ${CMAKE_INSTALL_PREFIX}/lib/${DIST_DIR}/lib${TARGET}${LIB_SUFFIX})")
# ==================================================================================================
# Java APIs
# ==================================================================================================
set(TARGET filament-java)
find_package(Java REQUIRED)
include(UseJava)
set(FILAMENT_JAVA_DIR ${FILAMENT_DIR}/src/main/java/)
get_filename_component(FILAMENT_JAVA_DIR ${FILAMENT_JAVA_DIR} ABSOLUTE)
set(JAVA_SOURCE_FILES
${FILAMENT_JAVA_DIR}/com/google/android/filament/Box.java
${FILAMENT_JAVA_DIR}/com/google/android/filament/Camera.java
${FILAMENT_JAVA_DIR}/com/google/android/filament/Colors.java
${FILAMENT_JAVA_DIR}/com/google/android/filament/Engine.java
${FILAMENT_JAVA_DIR}/com/google/android/filament/Entity.java
${FILAMENT_JAVA_DIR}/com/google/android/filament/EntityInstance.java
${FILAMENT_JAVA_DIR}/com/google/android/filament/EntityManager.java
${FILAMENT_JAVA_DIR}/com/google/android/filament/Fence.java
${FILAMENT_JAVA_DIR}/com/google/android/filament/Filament.java
${FILAMENT_JAVA_DIR}/com/google/android/filament/IndexBuffer.java
${FILAMENT_JAVA_DIR}/com/google/android/filament/IndirectLight.java
${FILAMENT_JAVA_DIR}/com/google/android/filament/LightManager.java
${FILAMENT_JAVA_DIR}/com/google/android/filament/Material.java
${FILAMENT_JAVA_DIR}/com/google/android/filament/MaterialInstance.java
${FILAMENT_JAVA_DIR}/com/google/android/filament/NativeSurface.java
${FILAMENT_JAVA_DIR}/com/google/android/filament/NioUtils.java
${FILAMENT_JAVA_DIR}/com/google/android/filament/Platform.java
${FILAMENT_JAVA_DIR}/com/google/android/filament/RenderableManager.java
${FILAMENT_JAVA_DIR}/com/google/android/filament/Renderer.java
${FILAMENT_JAVA_DIR}/com/google/android/filament/Scene.java
${FILAMENT_JAVA_DIR}/com/google/android/filament/Skybox.java
${FILAMENT_JAVA_DIR}/com/google/android/filament/Stream.java
${FILAMENT_JAVA_DIR}/com/google/android/filament/SwapChain.java
${FILAMENT_JAVA_DIR}/com/google/android/filament/Texture.java
${FILAMENT_JAVA_DIR}/com/google/android/filament/TextureSampler.java
${FILAMENT_JAVA_DIR}/com/google/android/filament/TransformManager.java
${FILAMENT_JAVA_DIR}/com/google/android/filament/VertexBuffer.java
${FILAMENT_JAVA_DIR}/com/google/android/filament/View.java
${FILAMENT_JAVA_DIR}/com/google/android/filament/Viewport.java
# Desktop specific
src/java/com/google/android/filament/DesktopPlatform.java
src/java/com/google/android/filament/FilamentCanvas.java
src/java/com/google/android/filament/FilamentPanel.java
src/java/com/google/android/filament/FilamentTarget.java
)
add_jar(${TARGET}
SOURCES ${JAVA_SOURCE_FILES}
INCLUDE_JARS lib/support-annotations.jar)
install_jar(${TARGET} lib)
Binary file not shown.
@@ -0,0 +1,53 @@
/*
* Copyright (C) 2018 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.google.android.filament;
import com.google.android.filament.Platform;
public class DesktopPlatform extends Platform {
public DesktopPlatform() {
}
@Override
void log(String message) {
System.out.println(message);
}
@Override
void warn(String message) {
System.out.println(message);
}
boolean validateStreamSource(Object object) {
return false;
}
@Override
boolean validateSurface(Object object) {
return object instanceof java.awt.Canvas;
}
@Override
boolean validateSharedContext(Object object) {
return false;
}
@Override
long getSharedContextNativeHandle(Object sharedContext) {
return 0;
}
}
@@ -0,0 +1,67 @@
/*
* Copyright (C) 2018 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.google.android.filament;
import java.awt.Canvas;
import java.awt.Dimension;
import java.awt.Graphics;
import com.google.android.filament.Engine;
import com.google.android.filament.SwapChain;
import com.google.android.filament.View;
import com.google.android.filament.Renderer;
import android.support.annotation.NonNull;
public class FilamentCanvas extends Canvas implements FilamentTarget {
private SwapChain mSwapChain;
private boolean mHasPainted;
public FilamentCanvas() {
super();
mHasPainted = false;
}
@Override
public void paint(@NonNull Graphics g) {
// On windows, allowing paint more than once will lock the canvas filament renderer.
// Not allowing it at all will trigger weird behavior where maximizing and returning
// to previous window size prevent SwapBuffer from working properly. super.paint() must
// be allowed exactly once.
if (!mHasPainted) {
super.paint(g);
mHasPainted = true;
}
}
public boolean beginFrame(@NonNull Engine engine, @NonNull Renderer renderer) {
return renderer.beginFrame(getSwapChain(engine));
}
public void endFrame(Renderer renderer) {
renderer.endFrame();
}
@NonNull
private SwapChain getSwapChain(@NonNull Engine engine) {
if (mSwapChain == null) {
mSwapChain = engine.createSwapChain(this, 0);
}
return mSwapChain;
}
public void destroy(@NonNull Engine engine) {
}
}
@@ -0,0 +1,226 @@
/*
* Copyright (C) 2018 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.google.android.filament;
import java.awt.*;
import java.nio.IntBuffer;
import java.awt.image.BufferedImage;
import java.awt.image.DataBufferInt;
import javax.swing.JPanel;
import java.util.concurrent.ConcurrentLinkedDeque;
import java.util.concurrent.Executors;
import java.util.concurrent.ExecutorService;
import java.nio.ByteBuffer;
import android.support.annotation.NonNull;
/**
* A Swing friendly component which can be used if an AWT based FilamentCanvas object results in
* issues due to interactions with Swing lightweight pop-ups and tooltips. However keep in mind
* it carries a much higher cost of operation.
*/
public class FilamentPanel extends JPanel implements FilamentTarget {
/**
* A Slot contains a buffer for Filament to write and an Image for Swing to read.
* It is ok for the buffer capacity to be > height * width. The image however MUST
* be exactly of dimension height * width.
*/
class Slot {
IntBuffer buffer;
BufferedImage image;
Slot(int width, int height) {
buffer = ByteBuffer.allocateDirect(4 * width * height).asIntBuffer();
image = new BufferedImage(width, height, BufferedImage.TYPE_INT_ARGB);
}
}
/**
* SlotPool is a circular buffer which provide "Slot"s where ExecutorService thread can write
* pixels and Swing can read from. Its purpose it to reuse memory and avoid allocation. During
* "normal" operation, SlotPool will generate no memory allocations. During a resize, it will
* have to realloc for each frames if the surface gets bigger. If the new size of the frame is
* smaller, only new BufferedImage are allocated.
*/
private final static int NUM_SLOTS = 4;
class SlotPool {
private ConcurrentLinkedDeque<Slot> queue = new ConcurrentLinkedDeque<>();
public SlotPool() {
for (int i = 0; i < NUM_SLOTS; i++) {
Slot slot = new Slot(1, 1); // Zero sized BufferedImage are forbidden.
queue.add(slot);
}
}
/**
* Returns null if no more slots are available. Otherwise, returns a slot adequate to
* receive and process an image of dimension width * height * RGBA.
*/
public Slot getSlot(int width, int height) {
Slot slot = queue.poll();
// Sorry we are out.
if (slot == null) {
return slot;
}
// The slot can avoid an allocation and reuse the same BufferedImage if dimensions have
// not changed.
if (slot.image.getWidth() != width || slot.image.getHeight() != height) {
slot.image = new BufferedImage(width, height, BufferedImage.TYPE_INT_ARGB);
}
// The slot can avoid an allocation and reuse the same IntBuffer if it has the capacity.
if (slot.buffer.capacity() < width * height) {
slot.buffer = ByteBuffer.allocateDirect(4 * width * height).asIntBuffer();
} else {
// Reuse the buffer, just reset position
slot.buffer.rewind();
}
return slot;
}
public void putSlot(Slot slot) {
queue.add(slot);
}
}
private final SlotPool mSlotPool = new SlotPool();
private NativeSurface mNativeSurface;
private SwapChain mSwapChain;
private BufferedImage mImage = new BufferedImage(1, 1, BufferedImage.TYPE_INT_ARGB);
private final Object mImageLock = new Object();
private int mHeight;
private int mWidth;
private Dimension mBackendDimension = new Dimension(0, 0);
private static final ExecutorService sExecutor = Executors.newSingleThreadExecutor();
// Amount of padding added to surface dimension upon allocating them.
private static final int SURFACE_PADDING = 128;
@Override
public void paint(Graphics g) {
synchronized (mImageLock) {
g.drawImage(mImage, 0, 0, Color.BLACK, null);
}
}
/**
* This must be called on Filament thread.
* Prepare to renders to offscreen native window.
*/
public boolean beginFrame(@NonNull Engine engine, @NonNull Renderer renderer) {
ensureSurface(engine);
return renderer.beginFrame(mSwapChain);
}
/**
* This must be called on Filament thread.
* Pixels are read from the Gl (located in VRAM) and copied to the JVM (in RAM).
* Colors are converted from ABGR to RGBA. A BufferedImage is created (copy RAM to RAM
* of all pixels). Finally the image is drawn to screen via Graphics.drawImage (one more trip
* from RAM to VRAM).
*/
public void endFrame(@NonNull Renderer renderer) {
// By the time readPixel callback is invoked, the dimension of the Panel may have changed.
// Capture dimension so they match the current GL framebuffer.
int capturedWidth = mWidth;
int capturedHeight = mHeight;
// Get a slot where Filament can write its pixels and where we have an appropriately sized
// BufferedImage.
Slot slot = mSlotPool.getSlot(capturedWidth, capturedHeight);
if (slot == null) {
// It seems Filament is producing data faster than Swing can display it. Skip this frame
// to allow Swing to catch up.
renderer.endFrame();
return;
}
Texture.PixelBufferDescriptor pb = new Texture.PixelBufferDescriptor(slot.buffer,
Texture.Format.RGBA, Texture.Type.UBYTE, 1, 0, 0, 0, sExecutor, new Runnable() {
@Override
public void run() {
synchronized (mImageLock) {
// Copy pixels read from the GL into the BufferedImage. Then convert from RGBA
// to ARGB because that is what the BufferedImage expects.
int[] data = ((DataBufferInt) slot.image.getRaster().getDataBuffer()).getData();
slot.buffer.get(data, 0, capturedHeight * capturedWidth);
for (int i = 0; i < capturedHeight * capturedWidth; i++) {
int rgba = data[i];
data[i] = (rgba >>> 8) | (rgba << 24);
}
mImage = slot.image;
repaint();
mSlotPool.putSlot(slot);
}
}
});
renderer.readPixels(0, 0, mWidth, mHeight, pb);
renderer.endFrame();
}
private void createSurfaces(@NonNull Engine engine, int width, int height) {
mBackendDimension = new Dimension(width, height);
mNativeSurface = new NativeSurface(width, height);
mSwapChain = engine.createSwapChainFromNativeSurface(mNativeSurface, 0L);
}
private void destroySurfaces(@NonNull Engine engine) {
if (mNativeSurface == null) {
return;
}
mNativeSurface.dispose();
engine.destroySwapChain(mSwapChain);
}
private void ensureSurface(@NonNull Engine engine) {
// Capture the dimension at the time the surface was ensured.
mWidth = getWidth();
mHeight = getHeight();
if (mBackendDimension.width < mWidth || mBackendDimension.height < mHeight) {
destroySurfaces(engine);
// A surface needs to be allocated. Allocate something a little bit bigger than
// necessary in order to avoid reallocating too often if the Panel is resized.
int widthToAllocate = mWidth + SURFACE_PADDING;
int heightToAllocate = mHeight + SURFACE_PADDING;
createSurfaces(engine, widthToAllocate, heightToAllocate);
}
}
/**
* This must be called on Filament thread.
*/
public void destroy(@NonNull Engine engine) {
destroySurfaces(engine);
}
}
@@ -0,0 +1,25 @@
/*
* Copyright (C) 2018 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.google.android.filament;
import android.support.annotation.NonNull;
public interface FilamentTarget {
boolean beginFrame(Engine engine, Renderer renderer);
void endFrame(@NonNull Renderer renderer);
void destroy(@NonNull Engine engine);
}