Işıklandırma Tahmini'ni kendi uygulamalarınızda nasıl kullanacağınızı öğrenin.
Ön koşullar
Devam etmeden önce temel AR kavramlarını ve ARCore oturumunu nasıl yapılandıracağınızı anladığınızdan emin olun.
API'yi uygun modla oturum başına bir kez yapılandırın.
Kullanmak istediğiniz mod için Işık Tahmini'ni oturum başına bir kez yapılandırın.
Java
// Configure the session with the Lighting Estimation API in ENVIRONMENTAL_HDR mode.
Config config = session.getConfig();
config.setLightEstimationMode(LightEstimationMode.ENVIRONMENTAL_HDR);
session.configure(config);
// Configure the session with the Lighting Estimation API in AMBIENT_INTENSITY mode.
Config config = session.getConfig();
config.setLightEstimationMode(LightEstimationMode.AMBIENT_INTENSITY);
session.configure(config);
// Configure the session with the Lighting Estimation API turned off.
Config config = session.getConfig();
config.setLightEstimationMode(LightEstimationMode.DISABLED);
session.configure(config);
Kotlin
// Configure the session with the Lighting Estimation API in ENVIRONMENTAL_HDR mode.
Config config = session.config
config.lightEstimationMode = LightEstimationMode.ENVIRONMENTAL_HDR
session.configure(config)
// Configure the session with the Lighting Estimation API in AMBIENT_INTENSITY mode.
Config config = session.config
config.lightEstimationMode = LightEstimationMode.AMBIENT_INTENSITY
session.configure(config)
// Configure the session with the Lighting Estimation API turned off.
Config config = session.config
config.lightEstimationMode = LightEstimationMode.DISABLED
session.configure(config)
ENVIRONMENTAL_HDR
modunu yapılandır
ENVIRONMENTAL_HDR
modunu yapılandırmak için her kare için ışık tahmini alın, ardından kullanmak istediğiniz ortam HDR ışıklandırma bileşenlerini öğrenin.
Java
void update() {
// Get the current frame.
Frame frame = session.update();
// Get the light estimate for the current frame.
LightEstimate lightEstimate = frame.getLightEstimate();
// Get intensity and direction of the main directional light from the current light estimate.
float[] intensity = lightEstimate.getEnvironmentalHdrMainLightIntensity(); // note - currently only out param.
float[] direction = lightEstimate.getEnvironmentalHdrMainLightDirection();
app.setDirectionalLightValues(intensity, direction); // app-specific code.
// Get ambient lighting as spherical harmonics coefficients.
float[] harmonics = lightEstimate.getEnvironmentalHdrAmbientSphericalHarmonics();
app.setAmbientSphericalHarmonicsLightValues(harmonics); // app-specific code.
// Get HDR environmental lighting as a cubemap in linear color space.
Image[] lightmaps = lightEstimate.acquireEnvironmentalHdrCubeMap();
for (int i = 0; i < lightmaps.length /*should be 6*/; ++i) {
app.uploadToTexture(i, lightmaps[i]); // app-specific code.
}
}
Kotlin
fun update() {
// Get the current frame.
val frame = session.update()
// Get the light estimate for the current frame.
val lightEstimate = frame.lightEstimate
// Get intensity and direction of the main directional light from the current light estimate.
val intensity = lightEstimate.environmentalHdrMainLightIntensity
val direction = lightEstimate.environmentalHdrMainLightDirection
app.setDirectionalLightValues(intensity, direction) // app-specific code.
// Get ambient lighting as spherical harmonics coefficients.
val harmonics = lightEstimate.environmentalHdrAmbientSphericalHarmonics
app.ambientSphericalHarmonicsLightValues = harmonics // app-specific code.
// Get HDR environmental lighting as a cubemap in linear color space.
val lightMaps = lightEstimate.acquireEnvironmentalHdrCubeMap();
for ((index, lightMap) in lightMaps.withIndex()) { // 6 maps total.
app.uploadToTexture(index, lightMap); // app-specific code.
}
}
AMBIENT_INTENSITY
modunu yapılandır
AMBIENT_INTENSITY
modunun renk düzeltme bileşenini kullanmayı planlıyorsanız önce paylaşılan bir ayırmayı yeniden kullanarak her karede renk düzeltmesi ayırmaktan kaçının.
Java
// Avoid allocation on every frame.
float[] colorCorrection = new float[4];
Kotlin
val colorCorrection = floatArrayOf(0.0f, 0.0f, 0.0f, 0.0f)
Her kare için ışık tahmini alın, ardından kullanmak istediğiniz ortam yoğunluğu bileşenlerini öğrenin.
Java
void update() {
// Get the current frame.
Frame frame = session.update();
// Get the light estimate for the current frame.
LightEstimate lightEstimate = frame.getLightEstimate();
// Get the pixel intensity of AMBIENT_INTENSITY mode.
float pixelIntensity = lightEstimate.getPixelIntensity();
// Read the pixel color correction of AMBIENT_INTENSITY mode into colorCorrection.
lightEstimate.getColorCorrection(colorCorrection, 0);
}
Kotlin
fun update() {
// Get the current frame.
val frame = session.update()
// Get the light estimate for the current frame.
val lightEstimate = frame.lightEstimate
// Get the pixel intensity of AMBIENT_INTENSITY mode.
val pixelIntensity = lightEstimate.pixelIntensity
// Read the pixel color correction of AMBIENT_INTENSITY mode into colorCorrection.
lightEstimate.getColorCorrection(colorCorrection, 0)
}
Environmental HDR API'leriyle enerji tasarrufunu sağlama
Enerji tasarrufu, bir yüzeyden yansıyan ışığın, yüzeye çarpmadan önce olduğundan daha yoğun olmaması ilkesine dayanır. Bu kural, fiziksel olarak oluşturma işleminde uygulanır ancak genellikle video oyunları ve mobil uygulamalarda kullanılan eski oluşturma ardışık düzenlerinden çıkarılır.
Çevresel HDR ışık tahmini içeren fiziksel tabanlı bir oluşturma ardışık düzeni kullanıyorsanız sanal nesnelerinizde fiziksel tabanlı malzemelerin kullanıldığından emin olmanız yeterlidir.
Ancak fiziksel tabanlı bir ardışık düzen kullanmıyorsanız birkaç seçeneğiniz vardır:
Bunun için en ideal çözüm, fiziksel tabanlı bir ardışık düzene geçmektir.
Ancak bu mümkün değilse iyi bir çözüm, fiziksel olmayan bir malzemeden elde edilen albedo değerini bir enerji tasarrufu faktörüyle çarpmaktır. Bu, en azından BRDF gölgelendirme modelinin fiziksel tabanlı biçime dönüştürülebilmesini sağlar. Her BRDF'nin farklı bir faktörü vardır. Örneğin, dağınık yansıma için 1/Pi'dır.