WebGL

کلاس WebGLOverlayView

‫google.maps.WebGLOverlayView کلاس

«نمای رونهاد WebGL» دسترسی مستقیم به همان بافت پرداز WebGL را فراهم می‌کند که «پلاتفرم Google Maps» برای پرداز نقشه پایه برداری استفاده می‌کند. این استفاده از بافت رندرینگ مشترک مزایایی مانند انسداد عمق با هندسه ساختمان سه‌بعدی و توانایی همگام‌سازی محتوای ۲بعدی/۳بعدی با رندرینگ نقشه پایه را فراهم می‌کند.

با «نمای رونهاد WebGL» می‌توانید بااستفاده مستقیم از WebGL یا کتابخانه‌های گرافیکی محبوب مثل Three.js یا deck.gl، به نقشه‌هایتان محتوا اضافه کنید. برای استفاده از هم‌پوشانی، می‌توانید google.maps.WebGLOverlayView را گسترش دهید و برای هریک از قلاب‌های چرخه حیات زیر پیاده‌سازی ارائه دهید: WebGLOverlayView.onAdd،‏ WebGLOverlayView.onContextRestored،‏ WebGLOverlayView.onDraw،‏ WebGLOverlayView.onContextLost، و WebGLOverlayView.onRemove.

باید WebGLOverlayView.setMap را با شیء Map معتبر فراخوانی کنید تا فراخوانی به روش onAdd() راه‌اندازی شود و setMap(null) تا روش onRemove() راه‌اندازی شود. روش setMap() را می‌توان در زمان ساخت یا در هر نقطه‌ای پس‌از آن که هم‌پوشانی باید پس‌از برداشتن دوباره نشان داده شود، فراخوانی کرد. سپس هرگاه ویژگی نقشه‌ای که می‌تواند موقعیت عنصر را تغییر دهد (مثل بزرگ‌نمایی، مرکز، یا نوع نقشه) تغییر کند، روش onDraw() فراخوانده می‌شود. WebGLOverlayView فقط می‌تواند به نقشه بُرداری دارای MapOptions.mapId اضافه شود (ازجمله نقشه‌هایی که روی RenderingType.VECTOR MapOptions.renderingType تنظیم شده‌اند و از Map.DEMO_MAP_ID به‌عنوان MapOptions.mapId استفاده می‌کنند).

این کلاس MVCObject را گسترش می‌دهد.

با تماس با const {WebGLOverlayView} = await google.maps.importLibrary("maps") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.
WebGLOverlayView
WebGLOverlayView()
پارامترها:  هیچ
WebGLOverlayView ایجاد می‌کند.
getMap
getMap()
پارامترها:  هیچ
مقدار برگشتی:  Map|null|undefined
onAdd
onAdd()
پارامترها:  هیچ
مقدار برگشتی:  هیچ
این روش را برای واکشی یا ایجاد ساختارهای داده واسط قبل‌از ترسیم هم‌پوشانی پیاده‌سازی کنید که به دسترسی فوری به بافت ارائه WebGL نیاز ندارند. این روش باید برای پردازش اجرا شود.
onContextLost
onContextLost()
پارامترها:  هیچ
مقدار برگشتی:  هیچ
این روش زمانی فراخوانی می‌شود که بافت رندرینگ به هر دلیلی ازدست برود و جایی است که باید هرگونه وضعیت GL ازپیش موجود را پاک کنید، زیرا دیگر به آن نیازی نیست.
onContextRestored
onContextRestored(options)
پارامترها: 
  • ‫options:  WebGLStateOptions که به توسعه‌دهندگان اجازه می‌دهد بافت GL را بازیابی کنند.
مقدار برگشتی:  هیچ
این روش زمانی فراخوانی می‌شود که بافت پردازش دردسترس باشد. از آن برای مقداردهی اولیه یا اتصال هر وضعیت WebGL مانند سایه‌زن‌ها یا اشیاء بافر استفاده کنید.
onDraw
onDraw(options)
پارامترها: 
  • options:  WebGLDrawOptions که به توسعه‌دهندگان اجازه می‌دهد محتوا را در نقشه پایه Google مرتبط ارائه دهند.
مقدار برگشتی:  هیچ
این روش را برای ترسیم محتوای WebGL مستقیماً روی نقشه پیاده‌سازی کنید. توجه داشته باشید که اگر هم‌پوشانی نیاز به ترسیم قاب جدیدی دارد، WebGLOverlayView.requestRedraw را فراخوانی کنید.
onRemove
onRemove()
پارامترها:  هیچ
مقدار برگشتی:  هیچ
این روش زمانی فراخوانی می‌شود که هم‌پوشانی با WebGLOverlayView.setMap(null) از نقشه برداشته شود و جایی است که باید همه اشیای واسطه را بردارید. این روش باید برای پردازش اجرا شود.
onStateUpdate
onStateUpdate(options)
پارامترها: 
  • ‫options:  WebGLStateOptions که به توسعه‌دهندگان اجازه می‌دهد بافت GL را بازیابی کنند.
مقدار برگشتی:  هیچ
این روش را برای مدیریت هرگونه به‌روزرسانی وضعیت GL خارج از قاب پویانمایی پرداز اجرا کنید.
requestRedraw
requestRedraw()
پارامترها:  هیچ
مقدار برگشتی:  هیچ
نقشه را برای بازترسیم قاب راه‌اندازی می‌کند.
requestStateUpdate
requestStateUpdate()
پارامترها:  هیچ
مقدار برگشتی:  هیچ
نقشه را برای به‌روزرسانی وضعیت GL راه‌اندازی می‌کند.
setMap
setMap([map])
پارامترها: 
  • map:  Map optional نقشه برای دسترسی به div، مدل، و حالت نما.
مقدار برگشتی:  هیچ
لایه را به نقشه اضافه می‌کند.
به‌ارث‌رسیده: addListener، bindTo، get، notify، set، setValues، unbind، unbindAll

میانای WebGLDrawOptions

میانا google.maps.WebGLDrawOptions

گزینه‌های طراحی.
gl
WebGLRenderingContext که این WebGLOverlayView باید روی آن پرداز زده شود.
transformer
تبدیل ماتریس از فضای دوربین به مختصات عرض جغرافیایی/طول جغرافیایی.

میانای WebGLStateOptions

میانا google.maps.WebGLStateOptions

گزینه‌های وضعیت GL.
gl
WebGLRenderingContext که این WebGLOverlayView باید روی آن پرداز زده شود.

میانای CoordinateTransformer

میانا google.maps.CoordinateTransformer

این میانجی روش‌های راحتی برای تولید ماتریس‌ها برای استفاده در رندر کردن صحنه‌های WebGL روی نقشه مبنای Google ارائه می‌دهد.

توجه: ارجاع به این شیء نباید خارج از محدوده فراخوانی WebGLOverlayView.onDraw کپسوله‌سازی نگهداری شود.
fromLatLngAltitude
fromLatLngAltitude(latLngAltitude[, rotations, scale])
پارامترها: 
  • latLngAltitude:  LatLngAltitude|LatLngAltitudeLiteral عرض جغرافیایی، طول جغرافیایی، و ارتفاع.
  • rotations:  Float32Array optional آرایه‌ای که حاوی زاویه چرخش اویلر برحسب درجه، در قرارداد XYZ است.
  • ‫scale:  Float32Array optional آرایه‌ای که حاوی آرایه اسکالر XYZ برای اعمال به محور اصلی است.
مقدار برگشتی:  Float64Array ماتریس MVP برای استفاده با WebGL.
getCameraParams
getCameraParams()
پارامترها:  هیچ
مقدار برگشتی:  پارامترهای دوربین CameraParams

میانای CameraParams

میانا google.maps.CameraParams

برای بازیابی پارامترهای دوربین استفاده می‌شود، مثل پارامترهای دوربین GL که برای WebGLOverlayView استفاده می‌شود.

این میانای گسترش‌یافته CameraOptions.

center
نوع:  LatLng
heading
نوع:  number
tilt
نوع:  number
zoom
نوع:  number