عناصر افتراضية إضاءة واقعية في المشهد

التعرّف على كيفية استخدام تقدير الإضاءة في تطبيقاتك الخاصة.

المتطلبات الأساسية

تأكَّد من فهم مفاهيم الواقع المعزّز الأساسية وكيفية ضبط جلسة ARCore قبل المتابعة.

ضبط واجهة برمجة التطبيقات مرة واحدة لكل جلسة باستخدام الوضع المناسب

اضبط ميزة "تقدير الإضاءة" مرة واحدة في الجلسة للوضع الذي تريد استخدامه.

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

لضبط وضع ENVIRONMENTAL_HDR، احصل على تقدير الإضاءة لكل لقطة، ثم احصل على مكوّنات الإضاءة ذات النطاق العالي الديناميكية التي تريد استخدامها.

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

إذا كنت تنوي استخدام مكوّن تصحيح الألوان في AMBIENT_INTENSITY عليك أولاً تجنب تخصيص تصحيح الألوان على كل إطار من خلال إعادة استخدام تخصيص مشترك.

Java

 // Avoid allocation on every frame.
float[] colorCorrection = new float[4];

Kotlin

val colorCorrection = floatArrayOf(0.0f, 0.0f, 0.0f, 0.0f)

يمكنك الحصول على تقدير للضوء لكل إطار، ثم الحصول على مكوّنات كثافة الإضاءة المحيطة. تريد استخدامها.

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

الحفاظ على الطاقة هو المبدأ الذي يعني أنّ الضوء المنعكس من سطح أقوى بكثير مما كانت عليه قبل أن تصل إلى السطح. هذه القاعدة يتم فرضها في العرض المستند إلى مادي، ولكن يتم حذفها عادةً من البيانات القديمة مسارات العرض المستخدمة في ألعاب الفيديو وتطبيقات الأجهزة الجوّالة.

في حال استخدام مسار عرض مستند إلى مادي مع ميزة Environmental HDR للضوء التقديري، فما عليك سوى التأكد من استخدام المواد المادية في الكائنات الافتراضية.

أما إذا كنتم لا تستخدمون قنوات مترابطة من الناحية المادية، فلديكم بعض الخيارات:

• الحل الأمثل لذلك هو الانتقال إلى مسار مستند إلى مسار مادي.

• إذا لم يكن ذلك ممكنًا، يمكنك استخدام حل بديل جيد وهو ضرب قيمة ملفه الشخصي للمواد غير المستندة إلى الخصائص الفيزيائية في عامل للحفاظ على الطاقة. يمكن أن يؤكد ذلك على الأقل من خلال نموذج تظليل BRDF يمكن تحويلها إلى نماذج مادية. لكل حساب BRDF عامل مختلف -- فعلى سبيل المثال، للانعكاس المنتشر، تكون 1/باي.